Welcome to the Cookbook

Seringkali pengguna baru dihadapkan pada permasalahan mod_rewrite, jadi disini akan sedikit disinggung mengenai hal tersebut. Jika halaman selamat datangnya CakePHP terlihat sedikit lucu (tidak ada gambar, atau gaya dari css), kemungkinan besar mod_rewrite tidak berfungsi dengan benar pada sistem anda. Berikut adalah beberapa anjuran yang semoga dapat membantu menyelesaikan masalah tersebut:

1. Pastikan bahwa setingan override untuk .htaccess diperbolehkan: pada httpd.conf, harus terdapat pendefinisian untuk masing-masing Directory pada server anda. Pastikan nilai untuk AllowOverride adalah All untuk Directory yang sesuai.

2. Pastikan anda menyunting berkas httpd.conf global, bukan berkas pada httpd.conf spesifik per-user atau per-site.

3. Mungkin juga anda mendapatkan salinan CakePHP tanpa berkas .htaccess yang dibutuhkan. Hal ini terkadang disebabkan karena beberapa jenis sistem operasi memperlakukan berkas yang berawalan '.' sebagai berkas tersebunyi (hidden), dan tidak mau menyalinnya. Pastikan anda mendapat salinan CakePHP dari bagian unduh yang resmi dari situs CakePHP atau dari gudang SVN-nya CakePHP.

4. Pastikan Apache memuat mod_rewrite dengan benar! Pada berkas httpd.conf anda harus terdapat bagian LoadModule rewrite_module libexec/httpd/mod_rewrite.so dan AddModule mod_rewrite.c.

Jika anda tidak ingin atau tidak dapat menggunakan/menjalankan mod_rewrite (atau modul lainnya dengan fungsi sejenis) pada server anda, anda dapat juga menggunakan URL cantik bawaan Cake. Pada berkas /app/config/core.php, buang tanda komentar pada baris yang berisi:

Configure::write('App.baseUrl', env('SCRIPT_NAME'));

1. Configure::write('App.baseUrl', env('SCRIPT_NAME'));

Kemudian buang berkas .htaccess berikut ini:

		/.htaccess
		/app/.htaccess
		/app/webroot/.htaccess
		

1. /.htaccess
2. /app/.htaccess
3. /app/webroot/.htaccess

Ini akan membuat URL anda kini nampak seperti www.example.com/index.php/controllername/actionname/param, tidak lagi www.example.com/controllername/actionname/param.