Mungkin banyak yang bertanya-tanya, kenapa file word, kenapa bukan file pdf saja. Secara coding memang lebih mudah jika yang digenerate adalah sebuah file pdf. Akan tetapi bisa saja sistem membutuhkan template surat yang dinamis, dapat berubah sewaktu-waktu, dapat diunggah oleh admin kapanpun, dan ketika surat yang sudah digenerate diunduh, surat tersebut memerlukan modifikasi lagi di luar sistem.

File word paling mengakomodasi kebutuhan-kebutuhan di atas. Sudah umum kita ketahui pengguna komputer awam sangat jarang yang menginstall editor pdf di komputernya, pada umumnya mereka memiliki editor word.

Langsung saja, pertama yang kita perlukan adalah library phpoffice/phpword. Install ke Yii2 menggunakan composer

composer require phpoffice/phpword:"*"

Tidak lupa kita tentukan template word yang dapat digunakan. Misal, template akan diisikan nama pengguna dan tanggal ketika file word tersebut diunduh.

Dapat diperhatikan ada dua “kata” yang tidak biasa, yaitu ${tanggalSurat} dan ${nama} kedua “kata” tersebut akan diubah oleh sistem saat pengguna mengunduh file word yang menggunakan template tersebut.

Tentu saja template word diatas harus diunggah ke server dan dapat diakses oleh Yii2. Saat pengguna mengunduh file word, Yii2 juga harus menentukan template mana yang akan digunakan. Tentang hal itu tidak akan dibahas di tutorial ini.

Langkah berikutnya adalah membuat action untuk mengunduh file word pada sebuah controller yang akan diakses oleh pengguna.

public function actionUnduhSurat()
{
	// Ambil template
	$fileTemplateWord = Yii::$app->basePath.'/web/upload/template_surat.docx';
	// Gunakan template prosesor
	$templateProcessor = new TemplateProcessor($fileTemplateWord);
	// Set value semua variabel yang ada di template
	$templateProcessor->setValue('tanggalSurat',date('j M Y');
	$templateProcessor->setValue('nama',Yii:$app->user->identity->nama);
	// Save file word di folder temporary server
	$temp_file_word = tempnam(sys_get_temp_dir(), 'PHPWord');
	$templateProcessor->saveAs($temp_file_word);
	// Kirimkan file untuk didownload oleh pengguna
	$filename = "Surat_Tugas.docx";
	header('Content-Description: File Transfer');
	header('Content-Type: application/octet-stream');
	header('Content-Disposition: attachment; filename='.$filename);
	header('Content-Transfer-Encoding: binary');
	header('Expires: 0');
	header('Cache-Control: must-revalidate, post-check=0, pre-check=0');
	header('Pragma: public');
	header('Content-Length: ' . filesize($temp_file_word));
	flush();
	readfile($temp_file_word);
	// Hapus file word dari folder temporary server
	unlink($temp_file_word);
}

composer require jasig/phpcas:"*"

Buat model untuk autentifikasi pengguna, misal CasAuth.php

use yii\base\Model;
use Yii;

class CasAuth extends Model
{
    public $username;

    private $_user = false;

    /**
     * Finds user by [[username]]
     *
     * @return Admin|null
     */
    public function getAdmin()
    {
        if ($this->_user === false) {
            $this->_user = Admin::findByUsername(trim(strtolower($this->username)));
        }

        return $this->_user;
    }

    public function loginAdmin()
    {
        $duration = 60*20;
        if ($this->username) {
            $user = $this->getAdmin();
            if ($user) {
                $user->last_login_time = date('Y-m-d H:i:s', time());
                $user->login_ip = Yii::$app->request->getUserIP();
                $user->update();
                return Yii::$app->user->login($this->getAdmin(),$duration);
            } else {
                return false;
            }

        } else {
            return false;
        }
    }
}

Pada baris ke-18 Admin::findByUsername(trim(strtolower($this->username))) adalah pemanggilan terhadap fungsi findByUsername dari model Admin. Fungsi ini akan mengembalikan satu record data Admin berdasarkan username. Model Admin selain extends ActiveRecord juga harus implements IdentityInterface.

use Yii;
use yii\db\ActiveRecord;
use yii\web\IdentityInterface;

class Admin extends ActiveRecord implements IdentityInterface
{
    const STATUS_DELETED = 0;
    const STATUS_ACTIVE = 10;
    ...
    /**
     * Finds user by username
     *
     * @param string $username
     * @return static|null
     */
    public static function findByUsername($username)
    {
        return static::findOne(['username' => $username, 'status' => self::STATUS_ACTIVE]);
    }

    ...
}

Buat actionLogin pada file SiteController.php jadi seperti dibawah ini:

    public function actionLogin()
    {
        \phpCAS::client(CAS_VERSION_2_0, Yii::$app->params['casHost'] , Yii::$app->params['casPort'], Yii::$app->params['casContext']);

        \phpCAS::setNoCasServerValidation();
        \phpCAS::handleLogoutRequests(false);
        \phpCAS::forceAuthentication();

        $username = \phpCAS::getUser();

        $model = new CasAuth(['username'=>$username]);
        if ($model->loginAdmin()) {
            return $this->goHome();
        } else {
            if ($model) {
                $service = strval(Yii::$app->request->hostInfo.'/site');
                \phpCAS::logout(array('service'=>$service));
            }
            return $this->redirect('/site');
        }
    }

    public function actionLogout()
    {
        \phpCAS::client(CAS_VERSION_2_0, Yii::$app->params['casHost'], Yii::$app->params['casPort'], Yii::$app->params['casContext']);

        $service = strval(Yii::$app->request->hostInfo.'/site/logout-cas');
        \phpCAS::logout(array('service'=>$service));
    }

    public function actionLogoutCas()
    {
        Yii::$app->user->logout();

        return $this->goHome();
    }

Perhatikan baris ke-3 Yii::$app->params['casHost'], Yii::$app->params['casPort'], dan Yii::$app->params['casContext'] adalah konfigurasi server CAS yang telah disimpan di file config\params-local.php. Lihat di bawah ini

return [
    'casHost' => "sso.domain.com", // host CAS
    'casPort' => 443, // port CAS
    'casContext' => "",
    ....
];

Kembali ke fungsi actionLogin, pada baris ke-7 adalah fungsi untuk melakukan autentifikasi SSO ke server CAS, kemudian saat autentifikasi berhasil pada baris ke-9 username CAS disimpan ke variabel $username. Selanjutnya buat instance model CasAuth dengan inisialisasi username menggunakan variabel $username(baris ke-11).

Pada baris ke-12 lakukan pengecekan, apakah pengguna dengan username tersebut ada di dalam record data Admin.

Baris ke-17 cukup penting, karena bisa jadi pengguna dapat melakukan autentifikasi di sistem CAS tetapi tidak termasuk sebagai Admin. Untuk kasus seperti itu maka akan lebih baik jika pengguna tersebut dilogout sesionnya dari sistem CAS.