<?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 => 'uk',
  ),
  'this' => 
  array (
    0 => 'features.remote-files.php',
    1 => 'Using remote files',
    2 => 'Using remote files',
  ),
  'up' => 
  array (
    0 => 'features.php',
    1 => 'Можливості',
  ),
  'prev' => 
  array (
    0 => 'features.file-upload.errors.seealso.php',
    1 => 'Прогляньте також',
  ),
  'next' => 
  array (
    0 => 'features.connection-handling.php',
    1 => 'Connection handling',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'en',
    '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">Using remote files</h1>


  <p class="para">
   As long as <strong class="option unknown">allow_url_fopen</strong> is enabled in
   <var class="filename">php.ini</var>, you can use <abbr title="Hypertext Transfer Protocol">HTTP</abbr> and <abbr title="File Transfer Protocol">FTP</abbr> 
   URLs with most of the functions
   that take a filename as a parameter.  In addition, URLs can be
   used with the <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> and
   <span class="function"><a href="function.require-once.php" class="function">require_once</a></span> statements 
   (<strong class="option unknown">allow_url_include</strong> must be enabled for these).
   See <a href="wrappers.php" class="xref">Підтримувані протоколи та обгортки</a> for more information about the protocols
   supported by PHP.
  </p>
  <p class="para">
   For example, you can use this to open a file on a remote web server,
   parse the output for the data you want, and then use that data in a
   database query, or simply to output it in a style matching the rest
   of your website.
  </p>
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>Приклад #1 Getting the title of a remote page</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">/* This only works if the title and its tags are on one line */<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">
   You can also write to files on an FTP server (provided that you
   have connected as a user with the correct access rights). You
   can only create new files using this method; if you try to overwrite
   a file that already exists, the <span class="function"><a href="function.fopen.php" class="function">fopen()</a></span> call will
   fail.
  </p>
  <p class="para">
   To connect as a user other than &#039;anonymous&#039;, you need to specify
   the username (and possibly password) within the URL, such as
   &#039;<code class="literal">ftp://user:password@ftp.example.com/path/to/file</code>&#039;.
   (You can use the same sort of syntax to access files via
   <abbr title="Hypertext Transfer Protocol">HTTP</abbr> when they require Basic authentication.)
  </p>
  <p class="para">
   <div class="example" id="example-2">
    <p><strong>Приклад #2 Storing data on a remote server</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">/* Write the data here. */<br /></span><span style="color: #0000BB">fwrite </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">
     You might get the idea from the example above that you can use
     this technique to write to a remote log file. Unfortunately
     that would not work because the <span class="function"><a href="function.fopen.php" class="function">fopen()</a></span> call will
     fail if the remote file already exists. To do distributed logging
     like that, you should take a look at <span class="function"><a href="function.syslog.php" class="function">syslog()</a></span>.
    </p> 
   </p></blockquote>
  </p>

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