[PHP 8.3] posix: amendments and stub pages for new functions

[Girgias]

@devnexen as you know the most about POSIX could you help writing the documentation?

[devnexen]

I ll get to it sometime this week.

[devnexen]

<function>posix_eaccess</function> checks the effective user's permission of a file.

[devnexen]

The name of a file to be tested.

[devnexen]

<para>
        A mask consisting of one or more of <constant>POSIX_F_OK</constant>,
        <constant>POSIX_R_OK</constant>, <constant>POSIX_W_OK</constant> and
        <constant>POSIX_X_OK</constant>.
       </para>
       <para>
        <constant>POSIX_R_OK</constant>, <constant>POSIX_W_OK</constant> and
        <constant>POSIX_X_OK</constant> request checking whether the file
        exists and has read, write and execute permissions, respectively.
        <constant>POSIX_F_OK</constant> just requests checking for the
        existence of the file.
       </para>

[devnexen]

<para>
   <example>
    <title><function>posix_eaccess</function> example</title>
    <para>
     This example will check if the $file is readable and writable, otherwise
     will print an error message.
    </para>
    <programlisting role="php">
<![CDATA[
<?php

$file = 'some_file';

if (posix_eaccess($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);
}

?>
]]>

[devnexen]

<row>
      <entry>8.3.0</entry>
      <entry>
       Checks the effective user/group for a file, differing
       from <function>posix_access</function> which checks
       from the real user/group.
      </entry>
     </row>

[Girgias]

Superseded by #2928 2928