cvs: peardoc /ja/package http.xml /ja/package/http http-session2.xml /ja/package/http/http-session2 cookies.xml database.xml intro.xml /ja/package/system mount.xml /ja/package/system/mount intro.xml

http://cvs.php.net/viewvc.cgi/peardoc/ja/package/http.xml?r1=1.10&r2=1.11&diff_format=u
Index: peardoc/ja/package/http.xml
diff -u peardoc/ja/package/http.xml:1.10 peardoc/ja/package/http.xml:1.11
--- peardoc/ja/package/http.xml:1.10	Sat Nov  4 23:58:48 2006
+++ peardoc/ja/package/http.xml	Sun Dec 16 03:21:34 2007
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8" ?>
-<!-- EN-Revision: 1.11 Maintainer: elf Status: ready -->
-<!-- $Id: http.xml,v 1.10 2006/11/04 23:58:48 takagi Exp $ -->
+<!-- $Revision: 1.11 $ -->
+<!-- EN-Revision: 1.12 Maintainer: elf Status: ready -->
 <chapter id="package.http">
 
  <title>HTTP</title>
@@ -16,6 +16,7 @@
  &package.http.http-download;
  &package.http.http-request;
  &package.http.http-session;
+ &package.http.http-session2;
  &package.http.http-upload;
 
 </chapter>

http://cvs.php.net/viewvc.cgi/peardoc/ja/package/system/mount/intro.xml?view=markup&rev=1.1
Index: peardoc/ja/package/system/mount/intro.xml
+++ peardoc/ja/package/system/mount/intro.xml
<?xml version="1.0" encoding="utf-8" ?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.1 Maintainer: takagi Status: ready -->

<refentry id="package.system.mount.intro">
 <refnamediv>
  <refname>導入</refname>
  <refpurpose>
   ファイルシステムのマウントとアンマウント
  </refpurpose>
 </refnamediv>

 <refsect1 id="package.system.mount.intro.contrib">
  <title>貢献者</title>
  <para>
   <itemizedlist>
    <listitem><simpara>Brett Bieber</simpara></listitem>
   </itemizedlist>
  </para>
 </refsect1>

 <refsect1 id="package.system.mount.intro.desc">
  <title>説明</title>
  <para>
   <classname>System_Mount</classname>
   は、システムの <filename>/etc/fstab</filename>
   に記録されているファイルシステムやパーティションのマウントおよびアンマウントを行います。
   fstab ファイルは Unix/Linux
   ベースのシステムで一般に用いられているもので、
   ユーザがファイルシステム階層上にマウントできるファイルシステムやパーティションの一覧として使用します。
   root パーティションや boot パーティションなどのほかに、
   cdrom デバイスやその他のリムーバルメディアなども登録されることがあります。
  </para>

  <para>
   System_Mount コマンドは、File_Fstab を使用して
   <filename>/etc/fstab</filename> ファイルのエントリを取得し、
   マウント/アンマウント の操作を簡単に行えるようにします。
  </para>
 </refsect1>

 <refsect1>
  <title>System_Mount の使用法</title>
  <example>
   <title>一般的な使用法</title>
   <programlisting role="php">
    <![CDATA[
<?php
require_once 'System/Mount.php';

// mount クラスを作成します
$m = new System_Mount();

// CD-ROM エントリを表すオブジェクトを取得します
$cdrom = $m->getEntryForPath('/media/cdrom0');

if (PEAR::isError($cdrom)) {
    die($cdrom->message."\n");
}

// マウントします
$res = $cdrom->mount();
if (PEAR::isError($res)) {
    die($res->getMessage()."\n");
}

// その中身を表示します
print `ls {$cdrom->mountPoint}`;

// アンマウントします
$cdrom->unmount();
if (PEAR::isError($res)) {
    die($res->getMessage()."\n");
}
?>
]]></programlisting>
  </example>
  <para>
   まず最初に、
   <classname>System_Mount</classname>
   オブジェクトのインスタンスを作成する必要があります。
  </para>
  <para>
   <filename>/etc/fstab</filename> 内の対応するエントリのマウントポイントを使用して、
   マウントするオブジェクトを取得します。
   そしてエラーチェックを行い、エラーがなければ cdrom をマウントします。
  </para>

 </refsect1>

</refentry>

<!-- 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
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/viewvc.cgi/peardoc/ja/package/system/mount.xml?view=markup&rev=1.1
Index: peardoc/ja/package/system/mount.xml
+++ peardoc/ja/package/system/mount.xml
<?xml version="1.0" encoding="utf-8" ?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.1 Maintainer: takagi Status: ready -->

<sect1 id="package.system.mount">
 <title>System_Mount</title>

 <para>
  このパッケージは、ディスクやパーティションをマウントしたりアンマウントしたりするためのものです。
  対象となるディスクやパーティションは、Unix/Linux ベースのシステム上にあるファイルシステムテーブル
  (<filename>/etc/fstab</filename>) にあげられているものです。
  based systems.
 </para>
 <para>
  このパッケージをインストールするには
  <command>pear install System_Mount</command>
  とします。インストールさえしてしまえば、使い方は簡単です。
 </para>

 &package.system.mount.intro;
</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
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/viewvc.cgi/peardoc/ja/package/http/http-session2/intro.xml?view=markup&rev=1.1
Index: peardoc/ja/package/http/http-session2/intro.xml
+++ peardoc/ja/package/http/http-session2/intro.xml
<?xml version="1.0" encoding="utf-8" ?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.1 Maintainer: takagi Status: ready -->
<refentry id="package.http.http-session2.intro">
 <refnamediv>
  <refname>導入</refname>
  <refpurpose>
   <classname>HTTP_Session2</classname> について
  </refpurpose>
 </refnamediv>

 <refsect1 id="package.http.http-session2.intro.overview">
  <title>概要</title>

  <para>
   このパッケージは、セッションステートやセッションレベルにアクセスしたり
   有効期限の管理用メソッドを使用したりすることができます。
   標準の <acronym>PHP</acronym> のセッション管理機能をもとにしていますが、
   データベースをコンテナに使用できたり、
   有効期限やアイドル時間を管理したりといった追加機能も提供しています。
  </para>

 </refsect1>

 <refsect1 id="package.http.http-session2.intro.examples">
  <title>ちょっとした例</title>

  <example>
   <title>オプションの設定と新規セッションの検出</title>

   <programlisting role="php">
HTTP_Session2::useCookies(false);
HTTP_Session2::start('MySessionID');
HTTP_Session2::set('variable', 'The string');
if (HTTP_Session2::isNew()) {
    echo('現在のリクエストで新たなセッションが作成されました');
    $visitors++; // 訪問者数の更新
}
   </programlisting>
  </example>


  <example>
   <title>タイムアウトの設定</title>

   <programlisting role="php">
HTTP_Session2::start();
HTTP_Session2::setExpire(time() + 60 * 60); // 有効期限は 1 時間
HTTP_Session2::setIdle(time() + 10 * 60);   // アイドル時間は 10 分

// 期限切れ
if (HTTP_Session2::isExpired()) {
    echo('セッションの有効期限が切れました!');
    HTTP_Session2::destroy();
}

// アイドル
if (HTTP_Session2::isIdle()) {
    echo '長い間放置しすぎました!';
    HTTP_Session2::destroy();
}

HTTP_Session2::updateIdle();
   </programlisting>

  </example>

  <para>
   持続的なセッションについてのよりわかりやすい例は、
   クッキーについてのセクションを参照ください。
  </para>

 </refsect1>

</refentry>
<!-- 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
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/viewvc.cgi/peardoc/ja/package/http/http-session2/database.xml?view=markup&rev=1.1
Index: peardoc/ja/package/http/http-session2/database.xml
+++ peardoc/ja/package/http/http-session2/database.xml
<?xml version="1.0" encoding="utf-8" ?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.1 Maintainer: takagi Status: ready -->
<refentry id="package.http.http-session2.database">
 <refnamediv>
  <refname>データベースコンテナの使用法</refname>
  <refpurpose>
   <classname>HTTP_Session2</classname> でセッションデータをデータベースに保存する方法
  </refpurpose>
 </refnamediv>

 <refsect1 id="package.http.http-session2.database.overview">
  <title>概要</title>

  <para>
   <classname>HTTP_Session</classname> を使用すると、
   セッションのデータをデータベースに保存することができます。
   これは、<classname>DB</classname> や <classname>MDB2</classname>
   パッケージを使用して行います。
  </para>
 </refsect1>

 <refsect1 id="package.http.http-session2.database.examples">
  <title>例</title>

  <example>
   <title>MDB2 によるセッションデータのデータベースへの保存</title>

   <programlisting role="php">
/* 以下のテーブルをデータベースに作成します
CREATE TABLE sessiondata (
    id     varchar(32) NOT NULL,
    expiry int(10),
    data   text,
    PRIMARY KEY (id)
);
*/

require_once 'HTTP/Session2.php';

HTTP_Session2::useTransSID(false);
HTTP_Session2::useCookies(false);

// DSN を指定します
HTTP_Session2::setContainer('MDB2',
    array('dsn' => 'mysql://root:password@localhost/database',
        'table' => 'sessiondata'));

/*
// 既存の MDB2 接続を使用する場合
HTTP_Session2::setContainer('MDB2',
    array('dsn'   => &amp;$db, 'table' => 'sessiondata'));
*/

HTTP_Session2::start('s');
HTTP_Session2::setExpire(time() + 60); // 有効期限を 60 秒とします
HTTP_Session2::setIdle(time() + 5);    // アイドル時間を 5 秒とします

if (HTTP_Session2::isExpired()) {
    HTTP_Session2::destroy();
}

if (HTTP_Session2::isIdle()) {
    HTTP_Session2::destroy();
}

HTTP_Session2::updateIdle();
   </programlisting>
  </example>

 </refsect1>

</refentry>
<!-- 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
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/viewvc.cgi/peardoc/ja/package/http/http-session2/cookies.xml?view=markup&rev=1.1
Index: peardoc/ja/package/http/http-session2/cookies.xml
+++ peardoc/ja/package/http/http-session2/cookies.xml
<?xml version="1.0" encoding="utf-8" ?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.1 Maintainer: takagi Status: ready -->
<refentry id="package.http.http-session2.cookies">
 <refnamediv>
  <refname>セッションの永続化</refname>
  <refpurpose>
   この例では、複数のブラウザ間で "セッションクッキー"
   を使用してセッションを永続化させる方法を示します
  </refpurpose>
 </refnamediv>

 <refsect1 id="package.http.http-session2.cookies.intro">
  <title>概要</title>

  <para>
   <classname>HTTP_Session</classname> を使用すると、
   セッションのデータをデータベースに保存することができます。
   これは、<classname>DB</classname> や <classname>MDB2</classname>
   パッケージを使用して行います。
  </para>
 </refsect1>

 <refsect1 id="package.http.http-session2.cookies.examples">
  <title>例</title>

  <example>
   <title>MDB2 によるセッションデータのデータベースへの保存</title>

   <programlisting role="php">
require_once 'HTTP/Session2.php';

/**
 * クッキーパラメータの設定
 */
session_set_cookie_params(60*60*24, // 有効期限は 24 時間
    '/',                            // パス
    '.example.org',                 // ドメイン
    false,                          // "secure only"
    true);                          // http のみ

HTTP_Session2::useCookies(true);

HTTP_Session2::start('s');
HTTP_Session2::setExpire(time() + 60*60*24); // 有効期限を 24 時間とします
HTTP_Session2::setIdle(time() + 60*60);      // アイドル時間を 1 時間とします

if (HTTP_Session2::isExpired()) {
    HTTP_Session2::destroy();
}

if (HTTP_Session2::isIdle()) {
    HTTP_Session2::destroy();
}

HTTP_Session2::updateIdle();
   </programlisting>
  </example>

 </refsect1>

</refentry>
<!-- 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
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/viewvc.cgi/peardoc/ja/package/http/http-session2.xml?view=markup&rev=1.1
Index: peardoc/ja/package/http/http-session2.xml
+++ peardoc/ja/package/http/http-session2.xml
<?xml version="1.0" encoding="utf-8" ?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.1 Maintainer: takagi Status: ready -->
<sect1 id="package.http.http-session2">
 <title>HTTP_Session2</title>

 <para>
  HTTP_Session2 パッケージは、session_*
  系の関数へのオブジェクト指向なインターフェイスを提供します。
  これは、<classname>HTTP_Session</classname>
  パッケージを PHP 5 用に移植したものです。
 </para>

 <para>
  HTTP_Session2 には、それ以外の機能もあります。
  たとえば <classname>DB</classname> や <classname>MDB2</classname>
  パッケージを使用してセッションデータをデータベースに保存することができます。
  また、isNew() や useCookies(), setExpire(), setIdle(),
  isExpired(), isIdled() などといった新しいメソッドも追加されています。
 </para>

 &package.http.http-session2.intro;
 &package.http.http-session2.database;
 &package.http.http-session2.cookies;

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