Panada PHP Framework 0.3.1 Documentation

Konfigurasi

Semua setting pengaturan aplikasi dilakukan pada file konfigurasi. Pengaturan-pengaturan ini termasuk: Base URL, Koneksi Database, Auto Load, Session, Alias Controller dan Alias Method, Query filter, Memcached dll.

Anda juga bisa menambahkan setting konfigurasi sesuai dengan kebutuhan aplikasi yang akan dibuat. Untuk melakukan hal ini lihat bagian Konfigurasi Tambahan

Konfigurasi Dasar

File konfigurasi Panada terletak pada direktori:


                    apps/config.php

Hal dasar yang harus dilengkapi pada bagian konfigurasi ini adalah URL dasar (base URL).

Isikan lokasi url aplikasi pada parameter base_url, misalnya:


                    $CONFIG['base_url'] = 'http://localhost/panada/';

Atau:


                    $CONFIG['base_url'] = 'http://www.mysite.com/';

Konfigurasi Tambahan

Untuk melakukan konfigurasi tambahan, buat sebuah key array baru dari variable $CONFIG, di mana nilai key-nya adalah nama config Anda.


                    $CONFIG['my_addition_config'] = 'my config value';

                    $CONFIG['my_array_config'] = array('setting_1' => 'foo');

Jika nilai dari config Anda berupa array, maka secara otomatis akan dirubah menjadi object.

Berikut adalah contoh untuk mendapatkan nilai config Anda di dalam file controller ataupun view:

Webserver

Secara default Panada menyertakan index.php di setiap url. Contohnya:


                    http://www.mysite.com/index.php/home

Jika Anda ingin menghilangkannya, pertama-tama beri nilai kosong ('') pada parameter index_file yang ada di dalam file apps/config.php. Ubah array berikut:


                    $CONFIG['index_file'] = 'index.php/';

Menjadi seperti berikut:


                    $CONFIG['index_file'] = '';

Berikutnya Anda juga perlu melakukan konfigurasi pada sisi webserver. Berikut ini penjelasan pengaturannya untuk webserver Apache, Nginx dan Lighttpd.

Apache

Tambahkan file .htaccess di root aplikasi yang isinya:
RewriteEngine on RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.*)$ index.php/$1 [L]
Nginx

Untuk webserver Nginx, gunakan konfigurasi berikut:
location / { root /www/var/your_site; index index.php index.html index.htm; if ($request_filename !~ (guide|js|css|images|robots\.txt.*) ) { rewrite ^/(.*)$ /index.php/$1 last; } } location ~ /index.php/ { fastcgi_pass 127.0.0.1:9000; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME /www/var/your_site/index.php; include fastcgi_params; }
Restart service Nginx.

Catatan: Jika Anda menggunakan Nginx, konfigurasi di atas harus dilakukan. Jika tidak, aplikasi tidak akan ter-routing dengan benar.
Anda juga harus menghapus comment yang ada pada file panada/library/uri.php pada method extract_uri_string() sehingga menjadi seperti berikut:
$path = str_replace($this->config->base_url, '', ($this->is_https())?'https://':'http://' . $_SERVER['SERVER_NAME']. $_SERVER['REQUEST_URI']); $path = $this->remove_query($path); if (trim($path, '/') != '' && trim($path, '/') != 'index.php') return '/'.$path;
Lighttpd

Buka dan edit file konfigurasi lighttpd, umumnya berada di:
/etc/lighttpd/lighttpd.conf
Edit pada bagian:
server.document-root = "/www/var/your_site/"
Pastikan modul mod_rewrite sudah tersedia:
server.modules = ( "mod_access", "mod_alias", "mod_accesslog", "mod_compress", "mod_rewrite" )
Kemudian tambahkan setting url rewrite seperti berikut di bagian manapun di dalam file konfigurasi Lighttpd:
url.rewrite-once = ( "/(.*)\.(.*)" => "$0", "/(css|files|img|js|stats)/" => "$0", "^/([^.]+)$" => "index.php/$1" )
Restart service lighttpd.

Jika konfigurasi webserver sudah dilakukan, baik itu Apache, Nginx ataupun Lighttpd, maka "index.php" di dalam url seharusnya sudah bisa dihilangkan.


                    http://www.mysite.com/home

Panada Framework 0.3.1 Documentation

Konfigurasi

Konfigurasi Dasar

Konfigurasi Tambahan

Webserver

Apache

Nginx

Lighttpd

Diskusi