cvs: phpdoc-id /install/unix apache1.xml apache2.xml
[email protected] ("Salman AS") Tue, 13 Sep 2005 02:48:15 -0000
| Newsgroups | php.doc.id |
|---|---|
| Message-ID | <cvssalman1126579695@cvsserver> |
--salman1126579695
Content-Type: text/plain
salman Mon Sep 12 22:48:15 2005 EDT
Added files:
/phpdoc-id/install/unix apache1.xml apache2.xml
Log:
Added: apache1.xml apache2.xml translated by [email protected] edited by [email protected]
--salman1126579695
Content-Type: text/plain
Content-Disposition: attachment; filename="salman-20050912224815.txt"
http://cvs.php.net/co.php/phpdoc-id/install/unix/apache1.xml?r=1.1&p=1
Index: phpdoc-id/install/unix/apache1.xml
+++ phpdoc-id/install/unix/apache1.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<sect1 id="install.unix.apache">
<title>Apache 1.3.x pada sistem Unix</title>
<para>
Bagian ini berisikan catatan dan petunjuk khusus untuk
instalasi Apache dengan PHP pada platform Unix. Kami juga
memiliki <link linkend="install.unix.apache2">instruksi
dan catatan untuk Apache 2 pada halaman terpisah</link>.
</para>
<para>
Anda dapat memilih argumen untuk dimasukkan ke
<command>configure</command> pada baris ke-10 di bawah dari
<link linkend="configure">daftar opsi konfigurasi</link>
dan dari opsi extension secara spesifik pada masing-masing
manual. Nomor versi diabaikan di sini supaya instruksi-instruksi
yang dimaksud tidak salah. Oleh karena itu Anda harus mengganti
tanda 'xxx' dengan nilai yang benar dari file-file tersebut.
</para>
<example id="install.unix.apache.example">
<title>
Petunjuk Instalasi (Versi Apache Shared Module) untuk PHP
</title>
<screen>
<![CDATA[
1. gunzip apache_xxx.tar.gz
2. tar -xvf apache_xxx.tar
3. gunzip php-xxx.tar.gz
4. tar -xvf php-xxx.tar
5. cd apache_xxx
6. ./configure --prefix=/www --enable-module=so
7. make
8. make install
9. cd ../php-xxx
10. Selanjutnya, konfigurasikan PHP. Di sini Anda harus mengatur PHP
dengan berbagai macam opsi, seperti extension mana yang akan dibuat
aktif. Gunakan ./configure --help untuk daftar opsi yang dapat
digunakan. Sebagai contoh, kita akan membuat konfigurasi dasar dengan
menggunakan Apache 1 dan dukungan terhadap MySQL. Lokasi path Anda
mungkin berbeda dengan yang ada di sini.
./configure --with-mysql --with-apxs=/www/bin/apxs
11. make
12. make install
Jika Anda berniat untuk mengubah opsi konfigurasi setelah instalasi,
Anda hanya perlu mengulangi tiga langkah yang terakhir (10, 11, dan 12).
Selanjutnya untuk melihat efeknya, restart apache untuk membuat module
baru. Anda tidak perlu melakukan kompilasi ulang.
Sebagai catatan, jika tidak disebutkan maka 'make install' juga akan
melakukan instalasi PEAR, berbagai macam tool PHP seperti phpize,
install PHP CLI, dan sebagainya.
13. Lakukan setup file php.ini:
cp php.ini-dist /usr/local/lib/php.ini
Anda dapat melakukan pengeditan file php.ini untuk mengatur opsi PHP.
Jika Anda ingin memindahkan file php.ini ke lokasi lain, gunakan
--with-config-file-path=/some/path pada langkah ke-10.
Jika Anda menggunakan file php.ini-recommended, bacalah dahulu daftar
perubahan-perubahan yang ada di dalamnya, karena hal ini ada hubungannya
dengan bagaimana PHP bekerja.
14. Edit file httpd.conf yang berguna untuk memanggil modul PHP. Path di
sebelah kanan text LoadModule merupakan path lokasi modul PHP pada sistem
Anda. Proses 'make install' di atas mungkin sudah memasukkannya secara
otomatis. Agar lebih yakinnya, sebaiknya Anda periksa apakah baris-baris
berikut ada di file httpd.conf.
Untuk PHP 4:
LoadModule php4_module libexec/libphp4.so
Untuk PHP 5:
LoadModule php5_module libexec/libphp5.so
15. Dan pada bagian AddModule di httpd.conf, di suatu tempat di bawah
ClearModuleList, masukkan baris berikut:
Untuk PHP 4:
AddModule mod_php4.c
Untuk PHP 5:
AddModule mod_php5.c
16. Beritahu Apache untuk mem-parse beberapa extension file PHP. Sebagai
contoh, untuk mem-parse extension .php dan .phtml sebagai extension PHP.
AddType application/x-httpd-php .php .phtml
Untuk memasukkan extension .phps sebagai file penting, ketik:
AddType application/x-httpd-php-source .phps
Jika diinginkan, Anda juga dapat memasukkan extension lain dengan diselingi
spasi.
17. Gunakan prosedur umum untuk menjalankan server Apache. (Anda harus
mematikan dan me-restart server, dan bukan hanya me-reload dengan
menggunakan sinyal HUP atau USR1.)
]]>
</screen>
</example>
<para>
Alternatifnya, untuk meng-install PHP sebagai objek statis:
</para>
<example id="install.unix.apache.example-static">
<title>
Petunjuk instalasi (Instalasi Modul Statis pada Apache) untuk PHP
</title>
<screen>
<![CDATA[
1. gunzip -c apache_1.3.x.tar.gz | tar xf -
2. cd apache_1.3.x
3. ./configure
4. cd ..
5. gunzip -c php-4.x.y.tar.gz | tar xf -
6. cd php-4.x.y
7. ./configure --with-mysql --with-apache=../apache_1.3.x
8. make
9. make install
10. cd ../apache_1.3.x
11. ./configure --prefix=/www --activate-module=src/modules/php4/libphp4.a
(Baris di atas benar! Ya, kami tahu bahwa libphp4.a tidak ada pada langkah ini.
Ini bukan berandai-andai. File ini akan diciptakan.)
12. make
(Seharusnya sekarang Anda memiliki binary httpd yang dapat Anda salin ke
direktori bin. Jika ini merupakan instalasi Anda yang pertama kali, gunakan
"make install")
13. cd ../php-4.x.y
14. cp php.ini-dist /usr/local/lib/php.ini
15. Anda dapat meng-edit file /usr/local/lib/php.ini untuk mengatur opsi PHP.
Edit file httpd.conf atau srm.conf file dan tambahkan:
AddType application/x-httpd-php .php
]]>
</screen>
</example>
<para>
Tergantung pada variant Apache dan Unix yang Anda gunakan, ada
berbagai macam cara untuk mematikan dan me-restart server. Di
bawah ini beberapa perintah yang dapat digunakan untuk me-restart
server untuk beberapa cara instalasi apache/unix yang berbeda.
Gantilah <literal>/path/to/</literal> dengan path aplikasi tersebut
pada sistem Anda.
</para>
<para>
<example>
<title>Contoh perintah-perintah untuk melakukan restart Apache</title>
<programlisting role="shell">
<![CDATA[
1. Beberapa varian Linux and SysV:
/etc/rc.d/init.d/httpd restart
2. Menggunakan script apachectl:
/path/to/apachectl stop
/path/to/apachectl start
3. httpdctl dan httpsdctl (menggunakan OpenSSL), mirip dengan apachectl:
/path/to/httpsdctl stop
/path/to/httpsdctl start
4. Menggunakan mod_ssl, atau SSL server lainnya, Anda mungkin perlu
mematikan dan menghidupaknnya secara manual:
/path/to/apachectl stop
/path/to/apachectl startssl
]]>
</programlisting>
</example>
</para>
<para>
Lokasi binari apachectl and http(s)dctl sering berubah-ubah. Jika
sistem Andabinaries often memiliki perintah <literal>locate</literal>
atau <literal>whereis</literal> atau <literal>which</literal>, Anda
dapat menggunakannya untuk membantu menemukan program-program
pengontrol server tersebut.
</para>
<para>
Contoh lainnya untuk melakukan kompilasi PHP untuk apache sebagai berikut:
<informalexample>
<programlisting role="shell">
<![CDATA[../configure --with-apxs --with-pgsql
]]>
</programlisting>
</informalexample>
</para>
<para>
Langkah ini akan menciptakan file <filename>libphp4.so</filename>
shared library yang akan dipanggil untuk menjalankan Apache
menggunakan LoadModule pada file Apache's &httpd.conf;. Dukungan
terhadap PostgreSQL ada dalam libary
<filename>libphp4.so</filename> ini.
</para>
<para>
<informalexample>
<programlisting role="shell">
<![CDATA[../configure --with-apxs --with-pgsql=shared
]]>
</programlisting>
</informalexample>
</para>
<para>
Langkah ini akan menciptakan file <filename>libphp4.so</filename>
shared library untuk Apache, namun juga akan membuat
<filename>pgsql.so</filename> shared library yang akan dipanggil
untuk menjalankan PHP baik menggunakan extension directive pada
file &php.ini; atau dengan memanggilnya secara eksplisit
(terang-terangan/jelas) pada script dengan menggunakan fungsi
<function>dl</function>.
</para>
<para>
<informalexample>
<programlisting role="shell">
<![CDATA[../configure --with-apache=/path/to/apache_source --with-pgsql
]]>
</programlisting>
</informalexample>
</para>
<para>
Langkah ini akan menciptakan file <filename>libmodphp4.a</filename>
library, file <filename>mod_php4.c</filename> dan beberapa file
lainnya yang akan menyalin dirinya ke direktori
<literal>src/modules/php4</literal> di pohon direktori Apache source.
Kemudian kompilasi Apache menggunakan
<literal>--activate-module=src/modules/php4/libphp4.a</literal>
dan Apache build system akan menciptakan file
<filename>libphp4.a</filename> dan menghubungkannya secara statis ke
binary file <filename>httpd</filename> binary. Dukungan terhadap
PostgreSQL support termasuk dalam binary <filename>httpd</filename>
ini, sehingga hasil akhirnya akan tercipta sebuah file binary tunggal
<filename>httpd</filename> yang mencakup semua bagian Apache dan PHP.
</para>
<para>
<informalexample>
<programlisting role="shell">
<![CDATA[../configure --with-apache=/path/to/apache_source --with-pgsql=shared
]]>
</programlisting>
</informalexample>
</para>
<para>
Sama seperti sebelumnya, namun di sini Anda tidak akan mendapatkan
dukungan terhadap PostgreSQL dengan terciptanya file akhir
<filename>httpd</filename>, Anda akan mendapatkan file
<filename>pgsql.so</filename> shared library yang dapat dipanggil
ke PHP, baik menggunakan file &php.ini; file maupun menggunakan fungsi
<function>dl</function>.
</para>
<para>
Jika Anda ingin membangun PHP dengan jalan yang berbeda-beda,
Anda harus memikirkan keuntungan dan keuntungan dari tiap-tiap metode.
Membangun sebagai shared object berarti Anda mengkompilasi PHP secara
manual, dan tidak perlu melakukan kompilasi ulang jika Anda ingin
menambahkan atau mengubah PHP. Membangun PHP pada apache (metode statis)
berarti PHP akan dipanggil dan berjalan dengan lebih cepat. Untuk
informasi lebih jelasnya, lihat Apache
<ulink url="&url.apachedso;">webpage on DSO support</ulink>.
</para>
<note>
<para>
Apache's default &httpd.conf; currently ships with a section that looks
like this:
<informalexample>
<programlisting role="apache-conf">
<![CDATA[
User nobody
Group "#-1"
]]>
</programlisting>
</informalexample>
Kecuali jika Anda ingin mengubah "Group nogroup" atau yang seperti itu
("Group daemon" juga biasa digunakan) PHP tidak Akan bisa membuka file.
</para>
</note>
<note>
<para>
Yakinkan Anda melakukan instalasi apxs mengunakan
<option role="configure">--with-apxs=/path/to/apxs</option>.
Anda TIDAK boleh menggunakan versi apsx yang ada di source apache,
kecuali yang telah ter-instalasi dalam sistem Anda.
</para>
</note>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
http://cvs.php.net/co.php/phpdoc-id/install/unix/apache2.xml?r=1.1&p=1
Index: phpdoc-id/install/unix/apache2.xml
+++ phpdoc-id/install/unix/apache2.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<sect1 id="install.unix.apache2">
<title>Apache 2.0 pada sistem Unix</title>
<para>
Bagian ini berisikan catatan dan petunjuk khusus untuk instalasi
Apache 2.0 dengan PHP pada sistem Unix.
</para>
&warn.apache2.compat;
<para>
Anda sangat diharapkan untuk melihat
<ulink url="&url.apache2.docs;">Dokumentasi Apache</ulink>
untuk memperoleh pengetahuan dasar menggunakan Apache 2.0 Server.
</para>
&install.snippet.apache2.compat;
<para>
Download versi terakhir <ulink url= "&url.apache;">Apache 2.0</ulink>
dan sesuaikan versi PHP-nya. Petunjuk singkat berikut hanya menekankan
petunjuk dasar untuk menggunakan Apache 2.0 bersama PHP. Untuk informasi
lebih lengkap silakan baca
<ulink url="&url.apache2.docs;">Dokumentasi Documentation</ulink>.
Nomor versi diabaikan di sini supaya instruksi-instruksi
yang dimaksud tidak salah. Oleh karena itu Anda harus mengganti
tanda 'NN' dengan nilai yang benar dari file-file tersebut.
</para>
<example>
<title>
Petunjuk Instalasi (Versi Apache 2 Shared Module)
</title>
<screen>
<![CDATA[
1. gzip -d httpd-2_0_NN.tar.gz
2. tar xvf httpd-2_0_NN.tar
3. gunzip php-NN.tar.gz
4. tar -xvf php-NN.tar
5. cd httpd-2_0_NN
6. ./configure --enable-so
7. make
8. make install
Sekarang Anda memiliki Apache 2.0.NN yang ada di dalam
/usr/local/apache2, yang dikonfigurasikan dengan dukungan terhadap
module yang daapt dipanggil dan standard MPM prefork.
Untuk melakukan pengujian terhadap instalasi yang dilakukan, gunakan
prosedur normal untuk menjalankan server Apache. Sebagai contoh:
/usr/local/apache2/bin/apachectl start
dan mematikan server untuk melakukan konfigurasi terhadap PHP:
/usr/local/apache2/bin/apachectl stop.
9. cd ../php-NN
10. Selanjutnya, konfigurasikan PHP. Di sini Anda harus mengatur PHP
dengan berbagai macam opsi, seperti extension mana yang akan dibuat
aktif. Gunakan ./configure --help untuk daftar opsi yang dapat
digunakan. Sebagai contoh, kita akan membuat konfigurasi dasar dengan
menggunakan Apache 2 dan dukungan terhadap MySQL. Lokasi path Anda di
mana apxs (mungkin namanya adalah apxs2) berada mungkin berbeda dengan
yang ada di sini.
./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-mysql
11. make
12. make install
Jika Anda berniat untuk mengubah opsi konfigurasi setelah instalasi,
Anda hanya perlu mengulangi tiga langkah yang terakhir (10, 11, dan 12).
Selanjutnya untuk melihat efeknya, restart apache untuk membuat modul
baru. Anda tidak perlu melakukan kompilasi ulang.
Sebagai catatan, jika tidak disebutkan maka 'make install' juga akan
melakukan instalasi PEAR, berbagai macam tool PHP seperti phpize,
install PHP CLI, dan sebagainya.
13. Lakukan setup file php.ini
cp php.ini-dist /usr/local/lib/php.ini
Anda dapat melakukan pengeditan file php.ini untuk mengatur opsi PHP.
Jika Anda ingin memindahkan file php.ini ke lokasi lain, gunakan
--with-config-file-path=/some/path pada langkah ke-10.
Jika Anda menggunakan file php.ini-recommended, bacalah dahulu daftar
perubahan-perubahan yang ada di dalamnya, karena hal ini ada hubungannya
dengan bagaimana PHP bekerja.
14. Edit file httpd.conf yang berguna untuk memanggil modul PHP. Path di
sebelah kanan text LoadModule merupakan path lokasi modul PHP pada sistem
Anda. Proses 'make install' di atas mungkin sudah memasukkannya secara
otomatis. Agar lebih yakinnya, sebaiknya Anda periksa apakah baris-baris
berikut ada di file httpd.conf.
Untuk PHP 4:
LoadModule php4_module modules/libphp4.so
Untuk PHP 5:
LoadModule php5_module modules/libphp5.so
16. Beritahu Apache untuk mem-parse beberapa extension file PHP. Sebagai
contoh, untuk mem-parse extension .php dan .phtml sebagai extension PHP.
AddType application/x-httpd-php .php .phtml
Untuk memasukkan extension .phps sebagai file penting, ketik:
AddType application/x-httpd-php-source .phps
Jika diinginkan, Anda juga dapat memasukkan extension lain dengan diselingi
spasi.
16. Gunakan prosedur umum untuk me-restart Apache server, seperti:
/usr/local/apache2/bin/apachectl start
]]>
</screen>
</example>
<para>
Langkah-langkah di bawah ini akan menjalankan Apache 2.0 denga dukungan
terhadap PHP sebagai modul <literal>SAPI</literal>.
Tentu saja ada berbagai macam opsi konfigurasi yang tersedia untuk
keduanya, Apache dan PHP. Untuk informasi lebih jelas gunakan
<command>./configure --help</command> pada struktur kode sumber yang bersangkutan.
Jika Anda ingin membangun versi multithreaded dari Apache 2.0, Anda harus
menimpa MPM-Module standar <filename>prefork</filename>, baik dengan
<filename>worker</filename> atau <filename>perchild</filename>.
Untuk melakukannya, tambahkan baris konfigurasi yang baru pada langkah 6
di atas, dengan menggunakan
<option role="configure">--with-mpm=worker</option> atau
<option role="configure">--with-mpm=perchild</option>. Berhati-hatilah
dengan konsekuensi-konsekuensinya dan Anda harus mengerti apa yang Anda
lakukan. Untuk informasi lebih jelas, bacalah dokumentasi
Apache mengenai <ulink url="&url.apache2.mpm;">MPM-Modules</ulink>.
</para>
<note>
<para>
Jika Anda ingin menggunakan content negotiation, bacalah
<link linkend="faq.installation.apache.multiviews">Apache MultiViews
FAQ</link>.
</para>
</note>
<note>
<para>
Untuk membangun versi multithreaded dari Apache, sistem Anda harus mendukung
threads. Hal ini dilakukan untuk membangun PHP dengan experimental
Zend Thread Safety (ZTS). Walaupun begitu, tidak semua extension tersedia.
Rekomendasinya, lakukan setup untuk membangun Apache menggunakan
<filename>prefork</filename> MPM-Module standar.
</para>
</note>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
--salman1126579695--