PHP 8.4.2 Released!

    chmod

    (PHP 4, PHP 5, PHP 7, PHP 8)

    chmod — Изменяет режим доступа к файлу

    Описание

    chmod(string $filename, int $permissions): bool

    Осуществляет попытку изменения режима доступа указанного файла на режим, переданный в параметре permissions.

    Список параметров

    filename

    Путь к файлу.

    permissions

    Обратите внимание, что значение параметра permissions не переводится автоматически в восьмеричную систему счисления, поэтому, чтобы удостовериться в том, что режим был установлен верно, предваряйте нулём (0) значение передаваемое в параметре permissions. Строки, такие как "g+w", не будут работать должным образом.

    <?php
    chmod    ("/somedir/somefile", 755); // десятичное, скорее всего, указано неверно
    chmod("/somedir/somefile", "u+rwx,go+rx"); // строка, неверный способ
    chmod("/somedir/somefile", 0755); // восьмеричное, верный способ
    ?>

    Значение параметра permissions состоит из трёх восьмеричных чисел, определяющих уровень доступа для владельца файла, для группы, в которую входит владелец, и для других пользователей, соответственно. Число, определяющее уровень пользователя, может быть вычислено путём суммирования значений, определяющих права: 1 - доступ на выполнение, 2 - доступ на запись, 4 - доступ на чтение. Сложите эти числа для указания нужного права доступа. Более подробно о системе прав в системах Unix вы можете узнать с помощью команд 'man 1 chmod' и 'man 2 chmod'.

    <?php
    // Доступ на запись и чтение для владельца, нет доступа для других
    chmod("/somedir/somefile", 0600);

    // Доступ на запись и чтение для владельца, доступ на чтение для других
    chmod("/somedir/somefile", 0644);

    // Полный доступ для владельца, доступ на чтение и выполнение для других
    chmod("/somedir/somefile", 0755);

    // Полный доступ для владельца, доступ на чтение и выполнение для группы владельца
    chmod("/somedir/somefile", 0750);
    ?>

    Возвращаемые значения

    Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.

    Ошибки

    В случае возникновения ошибки выдаётся ошибка уровня E_WARNING.

    Примечания

    Замечание:

    Текущим пользователем является пользователь, от имени которого выполняется PHP. Возможно, что это будет не тот пользователь, под именем которого вы получаете доступ к командной оболочке или учётной записи FTP. На большинстве систем режим доступа к файлу может быть изменён только его владельцем.

    Замечание: Функция неприменима для работы с удалёнными файлами, поскольку файл должен быть доступен через файловую систему сервера.

    Смотрите также

    • chown() - Изменяет владельца файла
    • chgrp() - Изменяет группу файла
    • fileperms() - Возвращает информацию о правах на файл
    • stat() - Возвращает информацию о файле

    Нашли ошибку?

    Инструкция • Исправление • Сообщение об ошибке
    ＋Добавить

    Примечания пользователей 6 notes

    up
    58
    MethodicalFool
    14 years ago
    BEWARE, a couple of the examples in the comments suggest doing something like this:

    chmod(file_or_dir_name, intval($mode, 8));

    However, if $mode is an integer then intval( ) won't modify it. So, this code...

    $mode = 644;
    chmod('/tmp/test', intval($mode, 8));

    ...produces permissions that look like this:

    1--w----r-T

    Instead, use octdec( ), like this:

    chmod(file_or_dir_name, octdec($mode));

    See also: http://www.php.net/manual/en/function.octdec.php
    up
    38
    Geoff W
    14 years ago
    BEWARE using quotes around the second parameter...

    If you use quotes eg

    chmod (file, "0644");

    php will not complain but will do an implicit conversion to an int before running chmod. Unfortunately the implicit conversion doesn't take into account the octal string so you end up with an integer version 644, which is 1204 octal
    up
    36
    masha at mail dot ru
    19 years ago
    Usefull reference:

    Value Permission Level
    400 Owner Read
    200 Owner Write
    100 Owner Execute
    40 Group Read
    20 Group Write
    10 Group Execute
    4 Global Read
    2 Global Write
    1 Global Execute

    (taken from http://www.onlamp.com/pub/a/php/2003/02/06/php_foundations.html)
    up
    8
    chris at ocproducts dot com
    4 years ago
    Windows has a very different file permission model to Unix and integrates them only minimally.

    On Windows, all this function can do is to change the "read only" flag, which is turned on if $mode & 0200 does not pass.
    i.e. it only checks if u+w is missing from the bitmask, and if it is, it sets the read only flag.

    The executable flag cannot be set as Windows determines it based on file extension.
    The write flag cannot be set as Windows determines write access based on ACLs, which are not integrated here.
    up
    6
    alex at feidesign dot com
    19 years ago
    If you cannot chmod files/directories with PHP because of safe_mode restrictions, but you can use FTP to chmod them, simply use PHP's FTP-functions (eg. ftp_chmod or ftp_site) instead. Not as efficient, but works.
    up
    2
    sander
    15 years ago
    if you want to chmod directories too, use this

    <?php
    $iterator     = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($pathname), RecursiveIteratorIterator::SELF_FIRST);

    foreach(    $iterator as $item) {
    chmod($item, $filemode);
    }
    ?>
    ＋Добавить
    To Top