Create a symbolic link
  • « eio_statvfs
  •  
  • eio_sync »
    • PHP Manual
    • Eio Functions
    • Create a symbolic link

    eio_symlink

    (PECL eio >= 0.0.1dev)

    eio_symlink — Create a symbolic link

    Description

    eio_symlink(
        string $path,
        string $new_path,
        int $pri = EIO_PRI_DEFAULT,
        callable $callback = NULL,
        mixed $data = NULL
    ): resource

    eio_symlink() creates a symbolic link new_path to path.

    Parameters

    path

    Source path

    new_path

    Target path

    pri

    The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or null. If null passed, pri internally is set to EIO_PRI_DEFAULT.

    callback

    callback function is called when the request is done. It should match the following prototype:

    void callback(mixed $data, int $result[, resource $req]);
    data

    is custom data passed to the request.

    result

    request-specific result value; basically, the value returned by corresponding system call.

    req

    is optional request resource which can be used with functions like eio_get_last_error().

    data

    Arbitrary variable passed to callback.

    Return Values

    eio_symlink() returns request resource on success, or false on failure.

    Examples

    Example #1 eio_symlink() example

    <?php
    $filename = dirname(__FILE__)."/symlink.dat";
    touch($filename);
    $link = dirname(__FILE__)."/symlink.link";
    
    function my_symlink_cb($data, $result) {
        global $link, $filename;
        var_dump(file_exists($data) && is_link($data));
    
        if (!eio_readlink($data, EIO_PRI_DEFAULT, "my_readlink_cb", NULL)) {
            @unlink($link);
            @unlink($filename);
        }
    }
    
    function my_readlink_cb($data, $result) {
        global $filename, $link;
        var_dump($result);
    
        @unlink($link);
        @unlink($filename);
    }
    
    eio_symlink($filename, $link, EIO_PRI_DEFAULT, "my_symlink_cb", $link);
    eio_event_loop();
    ?>

    The above example will output something similar to:

    bool(true)
    string(16) "/tmp/symlink.dat"

    See Also

    • eio_link() - Create a hardlink for file