<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/wrappers.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ja',
  ),
  'this' => 
  array (
    0 => 'wrappers.http.php',
    1 => 'http://',
    2 => 'HTTP(s) URL へのアクセス',
  ),
  'up' => 
  array (
    0 => 'wrappers.php',
    1 => 'サポートするプロトコル/ラッパー',
  ),
  'prev' => 
  array (
    0 => 'wrappers.file.php',
    1 => 'file://',
  ),
  'next' => 
  array (
    0 => 'wrappers.ftp.php',
    1 => 'ftp://',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ja',
    'path' => 'language/wrappers/http.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="wrappers.http" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">http://</h1>
  <h1 class="refname">https://</h1>
  <p class="refpurpose"><span class="refname">http://</span> -- <span class="refname">https://</span> &mdash; <span class="dc-title">HTTP(s) URL へのアクセス</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-wrappers.http-description">
  <h3 class="title">説明</h3>
  <p class="para">
   HTTP GET メソッドを用いて、
   ファイル/リソースに対する読み取り専用のアクセスが可能です。
   仮想ホストにホスト名でアクセスするために、
   <code class="literal">Host:</code> ヘッダが送信されます。
   <var class="filename">php.ini</var> ファイルまたはストリームコンテキストによって
   <a href="filesystem.configuration.php#ini.user-agent" class="link">user_agent</a> 文字列を設定している場合、
   それはリクエストの中にも含まれます。
  </p>
  <p class="simpara">
   ストリームにより、リソースの <em>body</em> にアクセスすることが
   できます。ヘッダは、<var class="varname"><a href="reserved.variables.httpresponseheader.php" class="classname">$http_response_header</a></var> 変数に保存されます。
  </p>
  <p class="simpara">
   (全てのリダイレクトが処理された後に)ドキュメント取得元のリソースの URL を知ることが
   重要な場合、ストリームから返された一連のレスポンスヘッダを処理する必要があります。
  </p>
  <p class="simpara">
   <a href="filesystem.configuration.php#ini.from" class="link">from</a> ディレクティブが設定されており、かつそれが
   <a href="context.php" class="xref">コンテキストオプションとパラメータ</a> で上書きされていない場合は、その値が
   <code class="literal">From:</code> ヘッダとなります。
  </p>
 </div>


 <div class="refsect1 usage" id="refsect1-wrappers.http-usage"> 
  <h3 class="title">利用法</h3>
  <ul class="itemizedlist">
   <li class="listitem"><span class="simpara"><var class="filename">http://example.com</var></span></li>
   <li class="listitem"><span class="simpara"><var class="filename">http://example.com/file.php?var1=val1&amp;var2=val2</var></span></li>
   <li class="listitem"><span class="simpara"><var class="filename">http://user:password@example.com</var></span></li>
   <li class="listitem"><span class="simpara"><var class="filename">https://example.com</var></span></li>
   <li class="listitem"><span class="simpara"><var class="filename">https://example.com/file.php?var1=val1&amp;var2=val2</var></span></li>
   <li class="listitem"><span class="simpara"><var class="filename">https://user:password@example.com</var></span></li>
  </ul>
 </div>
 

 <div class="refsect1 options" id="refsect1-wrappers.http-options">
  <h3 class="title">オプション</h3>
  <p class="para">
   <table class="doctable table">
    <caption><strong>ラッパーの概要</strong></caption>
    
     <thead>
      <tr>
       <th>属性</th>
       <th>サポートの可否</th>
      </tr>

     </thead>

     <tbody class="tbody">
      <tr>
       <td><a href="filesystem.configuration.php#ini.allow-url-fopen" class="link">allow_url_fopen</a> で制約される</td>
       <td>Yes</td>
      </tr>

      <tr>
       <td>読み込み可</td>
       <td>Yes</td>
      </tr>

      <tr>
       <td>書き込み可</td>
       <td>No</td>
      </tr>

      <tr>
       <td>追記可能</td>
       <td>No</td>
      </tr>

      <tr>
       <td>同時読み書き可</td>
       <td>N/A</td>
      </tr>

      <tr>
       <td><span class="function"><a href="function.stat.php" class="function">stat()</a></span> をサポート</td>
       <td>No</td>
      </tr>

      <tr>
       <td><span class="function"><a href="function.unlink.php" class="function">unlink()</a></span> をサポート</td>
       <td>No</td>
      </tr>

      <tr>
       <td><span class="function"><a href="function.rename.php" class="function">rename()</a></span> をサポート</td>
       <td>No</td>
      </tr>

      <tr>
       <td><span class="function"><a href="function.mkdir.php" class="function">mkdir()</a></span> をサポート</td>
       <td>No</td>
      </tr>

      <tr>
       <td><span class="function"><a href="function.rmdir.php" class="function">rmdir()</a></span> をサポート</td>
       <td>No</td>
      </tr>

     </tbody>
    
   </table>

  </p>
 </div>
 

 <div class="refsect1 examples" id="refsect1-wrappers.http-examples">
  <h3 class="title">例</h3>
  <div class="example" id="wrappers.http.example.basic">
   <p><strong>例1 リダイレクト後の URL の検出</strong></p>
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$url </span><span style="color: #007700">= </span><span style="color: #DD0000">'http://www.example.com/redirecting_page.php'</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">$fp </span><span style="color: #007700">= </span><span style="color: #0000BB">fopen</span><span style="color: #007700">(</span><span style="color: #0000BB">$url</span><span style="color: #007700">, </span><span style="color: #DD0000">'r'</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">$meta_data </span><span style="color: #007700">= </span><span style="color: #0000BB">stream_get_meta_data</span><span style="color: #007700">(</span><span style="color: #0000BB">$fp</span><span style="color: #007700">);<br />foreach (</span><span style="color: #0000BB">$meta_data</span><span style="color: #007700">[</span><span style="color: #DD0000">'wrapper_data'</span><span style="color: #007700">] as </span><span style="color: #0000BB">$response</span><span style="color: #007700">) {<br /><br />    </span><span style="color: #FF8000">/* リダイレクトされているか? */<br />    </span><span style="color: #007700">if (</span><span style="color: #0000BB">strtolower</span><span style="color: #007700">(</span><span style="color: #0000BB">substr</span><span style="color: #007700">(</span><span style="color: #0000BB">$response</span><span style="color: #007700">, </span><span style="color: #0000BB">0</span><span style="color: #007700">, </span><span style="color: #0000BB">10</span><span style="color: #007700">)) == </span><span style="color: #DD0000">'location: '</span><span style="color: #007700">) {<br /><br />        </span><span style="color: #FF8000">/* $url をリダイレクト先に書き換える */<br />        </span><span style="color: #0000BB">$url </span><span style="color: #007700">= </span><span style="color: #0000BB">substr</span><span style="color: #007700">(</span><span style="color: #0000BB">$response</span><span style="color: #007700">, </span><span style="color: #0000BB">10</span><span style="color: #007700">);<br />    }<br /><br />}<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </div>


 <div class="refsect1 notes" id="refsect1-wrappers.http-notes">
  <h3 class="title">注意</h3>
  <blockquote class="note"><p><strong class="note">注意</strong>: 
   <span class="simpara">
    HTTPS がサポートされるのは、<a href="book.openssl.php" class="link">openssl</a>
    拡張モジュールが有効な場合のみです。
   </span>
  </p></blockquote>
  <p class="simpara">
   HTTP 接続は読み込みのみ可で、HTTP リソースにデータを書き込んだり
   ファイルをコピーしたりすることはできません。
  </p>
  <p class="simpara">
   たとえば <em>POST</em> および <em>PUT</em> リクエストを送信することも、
   <a href="context.http.php" class="link">HTTP コンテキスト</a> を使えば可能です。
  </p>
 </div>


 <div class="refsect1 seealso" id="refsect1-wrappers.http-seealso">
  <h3 class="title">参考</h3>
  <ul class="simplelist">
   <li><a href="context.http.php" class="xref">HTTP コンテキストオプション</a></li>
   <li><var class="varname"><a href="reserved.variables.httpresponseheader.php" class="classname">$http_response_header</a></var></li>
   <li><span class="function"><a href="function.stream-get-meta-data.php" class="function" rel="rdfs-seeAlso">stream_get_meta_data()</a> - ヘッダーあるいはメタデータをストリームまたはファイルポインタから取得する</span></li>
  </ul>
 </div>


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