wip

Author: nsfisis

reference/ffi/book.xml

@@ -2,7 +2,6 @@
 <!-- $Revision$ -->
 <!-- EN-Revision: 46a9cdd2dbef4ec89bf65fad9930e2feb78bbb98 Maintainer: nsfisis Status: working -->
 
-!!!
 <book xml:id="book.ffi" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <?phpdoc extension-membership="bundled" ?>
  <title>外部関数インターフェース</title>
@@ -11,26 +10,26 @@
  <preface xml:id="intro.ffi">
   &reftitle.intro;
   <para>
-   This extension allows the loading of shared libraries (<filename>.DLL</filename> or
-   <filename>.so</filename>), calling of C functions and accessing of C data structures
-   in pure PHP, without having to have deep knowledge of the Zend extension API, and
-   without having to learn a third “intermediate” language.
-   The public API is implemented as a single class <classname>FFI</classname> with
-   several static methods (some of them may be called dynamically), and overloaded object
-   methods, which perform the actual interaction with C data.
+   この拡張は、Zend 拡張 API の深い知識が無くとも、あるいは第三の中間言語を学ぶことをせずとも、
+   純粋な PHP で共有ライブラリ (<filename>.DLL</filename> または <filename>.so</filename>)
+   を読み込んだり、C の関数を呼び出したり、C のデータ構造にアクセスしたりすることを
+   可能とします。
+   公開 API は単一のクラス <classname>FFI</classname> として実装されています。
+   このクラスの静的メソッド (そのうちのいくつかは非静的メソッドとしても呼び出せます) や
+   オーバーロードされたオブジェクトメソッドが、実際の C のデータとのやり取りを行います。
   </para>
   <caution>
    <para>
-    FFI is dangerous, since it allows to interface with the system on a very low level.
-    The FFI extension should only be used by developers having a working knowledge of C
-    and the used C APIs. To minimize the risk, the FFI API usage may be restricted
-    with the <link linkend="ini.ffi.enable">ffi.enable</link> &php.ini; directive.
+    FFI は、システムと低レベルでやり取りできるため危険です。
+    FFI 拡張は、C 言語と使われる C の API についての実用的な知識を持つ開発者のみによって
+    用いられるべきです。リスクを最小化するため、FFI API の使用は
+    <link linkend="ini.ffi.enable">ffi.enable</link> &php.ini; ディレクティブによって制限できます。
    </para>
   </caution>
   <note>
    <para>
-    The FFI extension does not render the classic PHP extension API obsolete; it is merely
-    provided for ad-hoc interfacing with C functions and data structures.
+    FFI 拡張は、古くからある PHP 拡張の API を廃止しようとしているわけではありません。
+    これは C の関数やデータ構造へのアドホックなインターフェースを提供するにすぎないのです。
    </para>
   </note>
   <tip>

reference/ffi/examples.xml

@@ -6,28 +6,28 @@
 <chapter xml:id="ffi.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.examples;
  <section xml:id="ffi.examples-basic">
-  <title>Basic FFI usage</title>
+  <title>FFI の基本的な使い方</title>
   <para>
-   Before diving into the details of the FFI API, lets take a look at a few examples
-   demonstrating the simplicity of the FFI API usage for regular tasks.
+   FFI API の詳細に深く立ち入る前に、よくあるタスクに対する FFI API の使い方が
+   どれほど簡単かを示す例をいくつか見てみましょう。
   </para>
   <note>
    <para>
-    Some of these examples require <filename>libc.so.6</filename> and as such will
-    not work on systems where it is not available.
+    これらの例の中には、<filename>libc.so.6</filename> を必要とするものがあります。
+    それらは、このライブラリが利用できないシステムでは動きません。
    </para>
   </note>
   <para>
    <example xml:id="ffi.examples.function">
-    <title>Calling a function from shared library</title>
+    <title>共有ライブラリの関数を呼ぶ</title>
     <programlisting role="php">
 <![CDATA[
 <?php
-// create FFI object, loading libc and exporting function printf()
+// FFI オブジェクトを作成し、libc を読み込んで printf() 関数をエクスポートする
 $ffi = FFI::cdef(
-    "int printf(const char *format, ...);", // this is a regular C declaration
+    "int printf(const char *format, ...);", // ここは通常の C の宣言
     "libc.so.6");
-// call C's printf()
+// C の printf() を呼ぶ
 $ffi->printf("Hello %s!\n", "world");
 ?>
 ]]>
@@ -42,17 +42,17 @@ Hello world!
   </para>
     <note>
    <para>
-    Note that some C functions need specific calling conventions, e.g. <literal>__fastcall</literal>,
-    <literal>__stdcall</literal> or <literal>,__vectorcall</literal>.
+    C の関数のうちのいくつかは、特定の呼び出し規約 (例: <literal>__fastcall</literal>、
+    <literal>__stdcall</literal>、<literal>,__vectorcall</literal> など) を必要とすることに注意してください。
    </para>
   </note>
   <para>
    <example xml:id="ffi.examples.structure">
-    <title>Calling a function, returning a structure through an argument</title>
+    <title>関数を呼び出し、構造体を引数経由で返す</title>
     <programlisting role="php">
 <![CDATA[
 <?php
-// create gettimeofday() binding
+// gettimeofday() のバインディングを作成する
 $ffi = FFI::cdef("
     typedef unsigned int time_t;
     typedef unsigned int suseconds_t;
@@ -69,14 +69,14 @@ $ffi = FFI::cdef("
  
     int gettimeofday(struct timeval *tv, struct timezone *tz);    
 ", "libc.so.6");
-// create C data structures
+// C のデータ構造を作成する
 $tv = $ffi->new("struct timeval");
 $tz = $ffi->new("struct timezone");
-// call C's gettimeofday()
+// C の gettimeofday() を呼ぶ
 var_dump($ffi->gettimeofday(FFI::addr($tv), FFI::addr($tz)));
-// access field of C data structure
+// C のデータ構造のフィールドにアクセスする
 var_dump($tv->tv_sec);
-// print the whole C data structure
+// C のデータ構造全体を出力する
 var_dump($tz);
 ?>
 ]]>
@@ -98,7 +98,8 @@ object(FFI\CData:struct timezone)#3 (2) {
   </para>
   <para>
    <example xml:id="ffi.examples.variable-existing">
-    <title>Accessing existing C variables</title>
+    <title>既存の C の変数にアクセスする</title>
+    !!!
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -121,7 +122,8 @@ int(0)
   </para>
   <para>
    <example xml:id="ffi.examples.variable-creating">
-    <title>Creating and Modifying C variables</title>
+    <title>C の変数を作成して書き換える</title>
+    !!!
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -151,7 +153,8 @@ int(7)
   </para>
   <para>
    <example xml:id="ffi.examples.array">
-    <title>Working with C arrays</title>
+    <title>C の配列を扱う</title>
+    !!!
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -185,7 +188,8 @@ int(8192)
   </para>
   <para>
     <example xml:id="ffi.examples.enum">
-    <title>Working with C enums</title>
+    <title>C の enum を扱う</title>
+    !!!
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -214,12 +218,15 @@ int(3)
   </para>
  </section>
  <section xml:id="ffi.examples-callback">
-  <title>PHP Callbacks</title>
+  <title>PHP のコールバック</title>
+  !!!
   <para>
    It is possible to assign a PHP closure to a native variable of function pointer type
    or to pass it as a function argument:
    <example>
+    !!!
     <title>Assigning a PHP <classname>Closure</classname> to a C function pointer</title>
+    !!!
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -255,17 +262,20 @@ Hello World 3!
 ]]>
     </screen>
    </example>
+   !!!
    Although this works, this functionality is not supported on all libffi platforms, is not efficient
    and leaks resources by the end of request.
    <tip>
     <simpara>
+     !!!
      It is therefore recommended to minimize the usage of PHP callbacks.
     </simpara>
    </tip>
   </para>
  </section>
 
  <section xml:id="ffi.examples-complete">
+  !!!
   <title>A Complete PHP/FFI/preloading Example</title>
   <informalexample>
    <simpara><filename>php.ini</filename></simpara>