Edit Report a Bug

    ftp://

    ftps://

    ftp:// -- ftps:// — Accessing FTP(s) URLs

    Description

    Allows read access to existing files and creation of new files via FTP. If the server does not support passive mode ftp, the connection will fail.

    You can open files for either reading or writing, but not both simultaneously. If the remote file already exists on the ftp server and you attempt to open it for writing but have not specified the context option overwrite, the connection will fail. If you need to overwrite existing files over ftp, specify the overwrite option in the context and open the file for writing. Alternatively, you can use the FTP extension.

    If you have set the from directive in php.ini, then this value will be sent as the anonymous FTP password.

    Usage

    • ftp://example.com/pub/file.txt
    • ftp://user:password@example.com/pub/file.txt
    • ftps://example.com/pub/file.txt
    • ftps://user:password@example.com/pub/file.txt

    Options

    Wrapper Summary
    Attribute Supported
    Restricted by allow_url_fopen Yes
    Allows Reading Yes
    Allows Writing Yes (new files/existing files with overwrite)
    Allows Appending Yes
    Allows Simultaneous Reading and Writing No
    Supports stat() filesize(), filemtime(), filetype(), file_exists(), is_file(), and is_dir() elements only.
    Supports unlink() Yes
    Supports rename() Yes
    Supports mkdir() Yes
    Supports rmdir() Yes

    Notes

    Note:

    FTPS is only supported when the openssl extension is enabled.

    If the server does not support SSL, then the connection falls back to regular unencrypted ftp.

    Note: Appending
    Files may be appended via the ftp:// URL wrapper.

    add a note add a note

    User Contributed Notes 3 notes

    up
    -7
    php at f00n dot com
    20 years ago
    For Intranet purposes I found I preferred to move my file via ftp functions to match the session user's ftp account and put the file in a holding bay so I knew who it was from.

    The FTP wrapper method will NOT do this if your ftp server does NOT support passive mode.

    eg.  an ftp server behind NAT/routing
    up
    -13
    Anonymous
    19 years ago
    <?
    $str     ="replace all contenents";
    $filew="ftp://gufo:gufo@192.168.1.55:21/jj.php";
    $opts = array('ftp' => array('overwrite' => true));
    $context = stream_context_create($opts);
    $strwri = file_put_contents($filew,$str,LOCK_EX,$context);
    ?>
    up
    -14
    fazil dot stormhammer dot nospam at gmail dot com
    16 years ago
    Document says "Allows read access to existing files and creation of new files via FTP. If the server does not support passive mode ftp, the connection will fail. "

    As of version 5.2.5 at least fopen("ftp://...") uses an ACTIVE mode connection by default (it issues an FTP PORT command but not a PASV command).  To force passive mode:

    $f = fopen("ftp://...");
    ftp_pasv($f, true);
    add a note add a note
    To Top