posix_access

(PHP 5 >= 5.1.0RC1)

posix_access --  Determine accessibility of a file

Description

bool posix_access ( string file [, int mode] )

posix_access() checks the user's permission of a file.

Note: When safe mode is enabled, PHP checks whether the files or directories you are about to operate on have the same UID (owner) as the script that is being executed.

Parameters

file

The name of the file to be tested.

mode

A mask consisting of one or more of POSIX_F_OK, POSIX_R_OK, POSIX_W_OK and POSIX_X_OK. Defaults to POSIX_F_OK.

POSIX_R_OK, POSIX_W_OK and POSIX_X_OK request checking whether the file exists and has read, write and execute permissions, respectively. POSIX_F_OK just requests checking for the existence of the file.

Return Values

Returns TRUE on success or FALSE on failure.

Examples

Example 1. posix_access() example

This example will check if the $file is readable and writable, otherwise will print an error message.

<?php

$file
= 'some_file';

if (
posix_access($file, POSIX_R_OK | POSIX_W_OK)) {
    echo
'The file is readable and writable!';

} else {
    
$error = posix_get_last_error();

    echo
"Error $error: " . posix_strerror($error);
}

?>

See Also

posix_get_last_error()
posix_strerror()