cvs: phpdoc-id /install ini.xml pecl.xml /install/unix gentoo.xml

[email protected] ("Salman AS") Fri, 30 Sep 2005 08:22:45 -0000
Newsgroups php.doc.id
Message-ID <cvssalman1128068565@cvsserver>
--salman1128068565
Content-Type: text/plain

salman		Fri Sep 30 04:22:45 2005 EDT

  Added files:                 
    /phpdoc-id/install	pecl.xml 

  Modified files:              
    /phpdoc-id/install	ini.xml 
    /phpdoc-id/install/unix	gentoo.xml 
  Log:
  Added pecl.xml translated by sas[at]salman.or.id.
  Modify ini.xml, found tag <i>. It is not used by docbook.
  
  
--salman1128068565
Content-Type: text/plain
Content-Disposition: attachment; filename="salman-20050930042245.txt"

http://cvs.php.net/diff.php/phpdoc-id/install/ini.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc-id/install/ini.xml
diff -u phpdoc-id/install/ini.xml:1.1 phpdoc-id/install/ini.xml:1.2
--- phpdoc-id/install/ini.xml:1.1	Sat Sep 10 21:53:27 2005
+++ phpdoc-id/install/ini.xml	Fri Sep 30 04:22:42 2005
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
  <chapter id="configuration">
   <title>Konfigurasi Runtime</title>
 
@@ -266,7 +266,6 @@
    </sect2>
    
    <sect2 id="configuration.changes.other">
-    <title>Other interfaces to PHP</title>
     <title>Antarmuka lain ke PHP</title>
     <para>
      Tak peduli bagaimana Anda menggunakan PHP, Anda dapat mengubah
http://cvs.php.net/diff.php/phpdoc-id/install/unix/gentoo.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc-id/install/unix/gentoo.xml
diff -u phpdoc-id/install/unix/gentoo.xml:1.1 phpdoc-id/install/unix/gentoo.xml:1.2
--- phpdoc-id/install/unix/gentoo.xml:1.1	Mon Sep 19 22:37:15 2005
+++ phpdoc-id/install/unix/gentoo.xml	Fri Sep 30 04:22:44 2005
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
 <sect1 id="install.unix.gentoo">
  <title>Catatan Instalasi di Gentoo</title>
  <para>
@@ -134,7 +134,7 @@
    </listitem>
    <listitem>
     <simpara>
-     Karena alasan masalah <em>slotting</em>, Anda mungkin akan mendapatkan
+     Karena alasan masalah <emphasis>slotting</emphasis>, Anda mungkin akan mendapatkan
      lebih dari satu versi PHP yang terinstal di sistem Anda. Jika ini
      terjadi, Anda harus meng-unmerge versi terakhir secara manual menggunakan
      perintah <command>emerge unmerge mod_php-&lt;old version&gt;</command>.

http://cvs.php.net/co.php/phpdoc-id/install/pecl.xml?r=1.1&p=1
Index: phpdoc-id/install/pecl.xml
+++ phpdoc-id/install/pecl.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->

<chapter id="install.pecl">
 <title>Installation of PECL extensions</title>

 <sect1 id="install.pecl.intro">
  <title>Pengantar Instalasi PECL</title>
  <simpara>
   Ekstensi PHP bisa jadi diinstal dengan cara yang berbeda-beda. <ulink
   url="&url.pecl;">PECL</ulink> adalah kumpulan ekstensi PHP yang berada
   dalam struktur <ulink url="&url.php.pear;">PEAR</ulink>, dan berikut ini
   adalah petunjuk bagaimana menginstal ekstensi-ekstensi tersebut.
  </simpara>
  <simpara>
   Instruksi berikut ini beranggapan bahwa <literal>/your/phpsrcdir/</literal>
   adalah path lengkap ke kode sumber PHP Anda, dan <literal>extname</literal>
   adalah nama ekstensi PECL. Sesuaikan dengan tepat. Instruksi-instruksi
   yang dijelaskan di sini juga Anda sudah terbiasa memakai <ulink
   url="&url.php.pear.cli;">perintah pear</ulink>.
  </simpara>
  <simpara>
   Ekstensi-ekstensi shared mungkin diinstal dengan memasukkan ke dalam
   &php.ini; menggunakan direktif PHP <link
   linkend="ini.extension">extension</link>. Lihat juga direktif <link
   linkend="ini.extension-dir">extensions_dir</link>, dan
   <function>dl</function>. Metoda instalasi yang dijelaskan di bawah ini
   tidak akan secara otomatis menyetel PHP agar memasukkan ekstensi-ekstensi
   ini, langkah ini harus dikerjakan secara manual.
  </simpara>
  <simpara>
   Ketika membangun modul-modul PHP, adalah sangat penting untuk menyediakan
   perangkat-perangkat yang diperlukan dengan versi yang tepat (autoconf,
   automake, libtool, etc.) Lihat <ulink url="&url.php.anoncvs;">Anonymous CVS
   Instructions</ulink> untuk mengetahui ditel informasi perangkat yang
   diperlukan dan versi yang sesuai.
  </simpara>
 </sect1>

 <sect1 id="install.pecl.downloads">
  <title>Mendapatkan ekstensi PECL</title>
  <simpara>
   Terdapat beberapa cara untuk mendapatkan ekstensi PECL, seperti:
  </simpara>
  <itemizedlist>
   <listitem>
    <simpara>
     <ulink url="&url.pecl;">&url.pecl;</ulink>
    </simpara>
    <simpara>
     Didaftar disini informasi seperti Changelog, informasi rilis, keperluan,
     revisi, dan sebagainya. Meskipun tidak semua ekstensi PECL memmpunyai
     situs, sebagian besar memilikinya.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <literal>pear download extname</literal>
    </simpara>
    <simpara>
     <ulink url="&url.php.pear.cli;">Perintah pear</ulink> juga bisa digunakan
     untuk mendapatkan file-file sumber. Revisi tertentu juga bisa kita
     sebutkan.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <acronym>CVS</acronym>
    </simpara>
    <simpara>
     Semua file-file PECL berada di dalam <acronym>CVS</acronym>. Untuk
     melihat struktur direktori menggunakan browser gunakan alamat <ulink
     url="&url.php.cvs;pecl/">&url.php.cvs;pecl/</ulink>. Untuk mendapatkan
     langsung dari <acronym>CVS</acronym>, gunakan <emphasis>phpfi</emphasis>
     sebagai password untuk user <emphasis>cvsread</emphasis>:
    </simpara>
    <para>
     <screen>
$ cvs -d:pserver:[email protected]:/repository login 
$ cvs -d:pserver:[email protected]:/repository co pecl/extname
     </screen>
    </para>
   </listitem>
   <listitem>
    <simpara>
     Windows downloads
    </simpara>
    <simpara>
     Para pengguna windows bisa mendapatkan PECL dalam format binary dengan
     mendownload <emphasis>Collection of PECL modules</emphasis> dari halaman
     <ulink url="&url.php.downloads;">PHP Downloads</ulink>, dan dengan
     mendapatkan <ulink url="&url.php.snapshots;">PECL Snapshot</ulink>. Untuk
     mengompilasi PHP dalam Windows, baca <ulink
     url="&url.php.win32.build.readme;">Win32 Build README</ulink>.
    </simpara>
   </listitem>
  </itemizedlist>
 </sect1>

 <sect1 id="install.pecl.windows">
  <title>PECL untuk pengguna Windows</title>
  <simpara>
   Seperti halnya ekstensi PHP <acronym>DLL</acronym> lainnya, untuk
   menginstal pindahkan file DLL ekstensi PECL ke dalam direktori <link
   linkend="ini.extension-dir">extension_dir</link> dan masukkan juga ke
   &php.ini;. Sebagai contoh:
  </simpara>
  <para>
   <screen>
extension=php_extname.dll
   </screen>
  </para>
  <simpara>
   Setelah itu, restart web server.
  </simpara>
 </sect1>
 
 <sect1 id="install.pecl.pear">
  <title>Mengompilasi ekstensi shared PECL dengan PEAR</title>
  <simpara>
   PEAR mempermudah membuat ekstensi shared PHP. Untuk menggunakan <ulink
   url="&url.php.pear.cli;">perintah pear</ulink>, kerjakan langkah berikut:
  </simpara>
  <para>
   <screen>
$ pear install extname
   </screen>
  </para>
  <simpara>
   Itu akan mendownload kode sumber untuk <emphasis>extname</emphasis>, dan
   mengompilasinya di dalam sistem. Hasilnya adalah file
   <filename>extname.so</filename> yang bisa dimasukkan ke dalam &php.ini;.
  </simpara>
  <simpara>
   Dalam kasus <emphasis>preferred_state</emphasis> sistem disetel lebih
   tinggi dari versi <emphasis>extname</emphasis>, misalnya disetel ke versi
   stabil dan ekstensinya sendiri masih versi beta, Anda bisa mengabaikan
   <emphasis>preferred_state</emphasis> lewat <literal>pear
   config-set</literal> atau tentukan versi tertentu ekstensi PECL. Sebagai
   contoh:
  </simpara>
  <para>
   <screen>
$ pear install extname-0.1.1
   </screen>
  </para>
  <simpara>
   Tanpa pikir panjang, pear akan menyalin file
   <filename>extname.so</filename> ini ke dalam <link
   linkend="ini.extension-dir">extensions directory</link>. Sesuaikan juga
   &php.ini;.
  </simpara>
 </sect1>

 <sect1 id="install.pecl.phpize">
  <title>Mengompilasi ekstensi shared PECL dengan phpize</title>
  <simpara>
   Jika menggunakan pear bukanlah sebuah kemungkinan, seperti halnya membangun
   ekstensi shared PECL dari <acronym>CVS</acronym>, atau untuk paket PECL
   yang belum dirilis, maka proses membuat ekstensi shared bisa dilakukan
   secara manual menggunakan perintah <literal>phpize</literal>. Perintah pear
   juga melakukan hal ini, hanya bisa juga dilakukan secara manual. Dengan
   asumsi file kode sumber diberi nama <filename>extname.tgz</filename>, dan
   dia didownload ke dalam direktori kerja, perhatikan berikut:
  </simpara>
  <para>
   <screen>
<![CDATA[
$ pear download extname
$ gzip -d < extname.tgz | tar -xvf -
$ cd extname
$ phpize
$ ./configure && make
]]>
   </screen>
  </para>
  <simpara>
   Setelah berhasil, ini akan membuat file <filename>extname.so</filename> dan
   letakkan dia ke dalam direktori <filename>modules/</filename> dan/atau
   <filename>.libs/</filename> dalam direktori sumber
   <filename>extname/</filename>. Pindahkan ekstensi shared ini
   (<filename>extname.so</filename>) ke dalam <link
   linkend="ini.extension-dir">extensions directory</link> PHP, dan sesuaikan
   &php.ini; dengan benar.
  </simpara>
 </sect1>

 <sect1 id="install.pecl.static">
  <title>Mengompilasi ekstensi PECL secara statik ke dalam PHP</title>
  <simpara>
   Untuk memasukkan ekstensi ke dalam PHP, letakkan kode sumber ekstensi ke
   dalam direktori <filename>ext/</filename> yang bisa ditemukan dalam
   struktur kode sumber PHP. Sebagai contoh:
  </simpara>
  <para>
   <screen>
<![CDATA[
$ cd /your/phpsrcdir/ext
$ pear download extname
$ gzip -d < extname.tgz | tar -xvf -
$ mv extname-x.x.x extname
$ rm package.xml
]]>
   </screen>
  </para>
  <simpara>
   Hasilnya adalah direktori berikut:
  </simpara>
  <para>
   <screen>
    /your/phpsrcdir/ext/extname
   </screen>
  </para>
  <simpara>
   Dari sini, bangun PHP seperti biasa:
  </simpara>
  <para>
   <screen>
$ cd /your/phpsrcdir 
$ rm configure
$ ./buildconf --force
$ ./configure --help
$ ./configure --with-extname --enable-someotherext --with-foobar
$ make
$ make install
   </screen>
  </para>
  <note>
   <simpara>
    Untuk menjalankan skrip 'buildconf', Anda membutuhkan autoconf 2.13 dan
    automake 1.4+ (versi terbaru autoconf mungkin bisa bekerja, tapi tidak
    disupport).
   </simpara>
  </note>
  <simpara>
   Apakah <literal>--enable-extname</literal> atau
   <literal>--with-extname</literal> yang digunakan sangat tergantung pada
   ekstensi. Biasanya ekstensi yang tidak memerlukan library eksternal
   menggunakan <literal>--enable</literal>. Untuk yakinnya, jalankan perintah
   berikut setelah buildconf:
  </simpara>
  <para>
   <screen>
$ ./configure --help | grep extname
   </screen>
  </para>
 </sect1>
</chapter>   

<!-- 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
-->

--salman1128068565--