<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/features.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ja',
  ),
  'this' => 
  array (
    0 => 'features.remote-files.php',
    1 => 'リモートファイルの使用',
    2 => 'リモートファイルの使用',
  ),
  'up' => 
  array (
    0 => 'features.php',
    1 => '機能',
  ),
  'prev' => 
  array (
    0 => 'features.file-upload.errors.seealso.php',
    1 => '参考',
  ),
  'next' => 
  array (
    0 => 'features.connection-handling.php',
    1 => '接続処理',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ja',
    'path' => 'features/remote-files.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="features.remote-files" class="chapter">
  <h1 class="title">リモートファイルの使用</h1>


  <p class="para">
   <var class="filename">php.ini</var>で<code class="parameter">allow_url_fopen</code>を有効にした場合、
   ファイル名をパラメータとする関数の多くで
   <abbr title="Hypertext Transfer Protocol">HTTP</abbr> および <abbr title="File Transfer Protocol">FTP</abbr> のURL
   を使用することができます。加えて、
   <span class="function"><a href="function.include.php" class="function">include</a></span>、
   <span class="function"><a href="function.include-once.php" class="function">include_once</a></span>、
   <span class="function"><a href="function.require.php" class="function">require</a></span> および
   <span class="function"><a href="function.require-once.php" class="function">require_once</a></span>
   命令でURLを使用することができます
   (これらで使用するためには
   <strong class="option unknown">allow_url_include</strong> を有効にする必要があります)。
   PHPがサポートしているプロトコルに関する詳細は
   <a href="wrappers.php" class="xref">サポートするプロトコル/ラッパー</a>を参照ください。
  </p>
  <p class="para">
   例えば、リモートWebサーバーにファイルをオープンし、データを出力、デー
   タベースクエリーに使用するか、単にWebサイトのスタイルに合わせて出力
   を行うことが可能です。
  </p>
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>例1 リモートページのタイトルを得る</strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$file </span><span style="color: #007700">= </span><span style="color: #0000BB">fopen </span><span style="color: #007700">(</span><span style="color: #DD0000">"http://www.example.com/"</span><span style="color: #007700">, </span><span style="color: #DD0000">"r"</span><span style="color: #007700">);<br />if (!</span><span style="color: #0000BB">$file</span><span style="color: #007700">) {<br />    echo </span><span style="color: #DD0000">"&lt;p&gt;Unable to open remote file.\n"</span><span style="color: #007700">;<br />    exit;<br />}<br />while (!</span><span style="color: #0000BB">feof </span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">)) {<br />    </span><span style="color: #0000BB">$line </span><span style="color: #007700">= </span><span style="color: #0000BB">fgets </span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">, </span><span style="color: #0000BB">1024</span><span style="color: #007700">);<br />    </span><span style="color: #FF8000">/* タイトルとタグが同じ行にある場合のみ動作します。 */<br />    </span><span style="color: #007700">if (</span><span style="color: #0000BB">preg_match </span><span style="color: #007700">(</span><span style="color: #DD0000">"@\&lt;title\&gt;(.*)\&lt;/title\&gt;@i"</span><span style="color: #007700">, </span><span style="color: #0000BB">$line</span><span style="color: #007700">, </span><span style="color: #0000BB">$out</span><span style="color: #007700">)) {<br />        </span><span style="color: #0000BB">$title </span><span style="color: #007700">= </span><span style="color: #0000BB">$out</span><span style="color: #007700">[</span><span style="color: #0000BB">1</span><span style="color: #007700">];<br />        break;<br />    }<br />}<br /></span><span style="color: #0000BB">fclose</span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>
  <p class="para">
   (正しいアクセス権限を有するユーザーとして接続した場合には)
   FTPサーバーにファイルを書き込むこともできます。
   この方法では、新規ファイルを作成することのみができます。
   既存のファイルを上書きしようとした場合には、
   <span class="function"><a href="function.fopen.php" class="function">fopen()</a></span>の処理は失敗します。
  </p>
  <p class="para">
   &#039;anonymous&#039; 以外のユーザーで接続を行う場合、URL の中で
   &#039;<code class="literal">ftp://user:password@ftp.example.com/path/to/file</code>&#039;
   のようにユーザー名 (そして多分パスワードも) 指定する必要があります
   (Basic 認証を要求された際に <abbr title="Hypertext Transfer Protocol">HTTP</abbr>
   経由でファイルをアクセスする場合と同じ種類の構文を使用することができます)。
  </p>
  <p class="para">
   <div class="example" id="example-2">
    <p><strong>例2 リモートサーバーにデータを保存する</strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$file </span><span style="color: #007700">= </span><span style="color: #0000BB">fopen </span><span style="color: #007700">(</span><span style="color: #DD0000">"ftp://ftp.example.com/incoming/outputfile"</span><span style="color: #007700">, </span><span style="color: #DD0000">"w"</span><span style="color: #007700">);<br />if (!</span><span style="color: #0000BB">$file</span><span style="color: #007700">) {<br />    echo </span><span style="color: #DD0000">"&lt;p&gt;Unable to open remote file for writing.\n"</span><span style="color: #007700">;<br />    exit;<br />}<br /></span><span style="color: #FF8000">/* データをここに書きます。 */<br /></span><span style="color: #0000BB">fputs </span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">, </span><span style="color: #0000BB">$_SERVER</span><span style="color: #007700">[</span><span style="color: #DD0000">'HTTP_USER_AGENT'</span><span style="color: #007700">] . </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">fclose </span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>
  <p class="para">
   <blockquote class="note"><p><strong class="note">注意</strong>: 
    <p class="para">
     上の例からリモートログに書きこむためにこの手法を使用することを考えるかも
     しれません。
     しかし残念ながら、リモート上のファイルが既に存在する状態では
     <span class="function"><a href="function.fopen.php" class="function">fopen()</a></span>をコールすることができないため、
     それはできません。
     分散ロギングのようなことを行うには、
     <span class="function"><a href="function.syslog.php" class="function">syslog()</a></span> の使用を考えてみてください。
    </p>
   </p></blockquote>
  </p>

 </div>
<?php manual_footer($setup); ?>