Lchgrp: примеры (PHP)

<?php
$link = 'symlink_to_file.txt';
$groupName = 'www-data';

if (lchgrp($link, $groupName)) {
    echo 'Группа символьной ссылки изменена.';
} else {
    echo 'Не удалось изменить группу.';
}
?>

Группа символьной ссылки изменена.

<?php
$link = 'data_link';
$gid = 33; // Например, GID для группы 'www-data'

$result = lchgrp($link, $gid);
var_dump($result);
?>

bool(true)

<?php
$link = 'non_existent_link';

if (!lchgrp($link, 'www-data')) {
    echo "Функция lchgrp вернула false. Возможно, ссылка не существует или недостаточно прав.";
}
?>

Функция lchgrp вернула false. Возможно, ссылка не существует или недостаточно прав.

chgrp() - Изменяет группу для обычного файла или каталога, а не для символической ссылки. Предпочтительна при работе с реальными файлами.

lchown() - Изменяет владельца символической ссылки. Используется вместе с lchgrp для полного управления правами доступа на симлинк.

chown() - Меняет владельца целевого файла. Не влияет на метаданные символьной ссылки.

chmod() - Изменяет права доступа к файлу. Работает с целевым объектом ссылки, а не с самой ссылкой.

<?php
$link = '/path/to/broken_symlink';
$result = lchgrp($link, 'www-data');
if ($result === false) {
    error_log("Ошибка lchgrp для $link");
}
?>

[error_log] Ошибка lchgrp для /path/to/broken_symlink

<?php
// Запуск скрипта от пользователя без привилегий
$link = '/etc/config_link';
if (!lchgrp($link, 'root')) {
    echo 'Отказано в доступе. Требуются права суперпользователя.';
}
?>

Отказано в доступе. Требуются права суперпользователя.

Функция не работает в операционных системах Windows, так как они не поддерживают символьные ссылки в том же виде.

<?php
// На Windows
$link = 'C:\link.txt';
var_dump(lchgrp($link, 1));
?>

bool(false)

В PHP 8.0.0 параметр $group теперь принимает как строку с именем группы, так и целочисленный идентификатор GID. Ранее разрешалось только числовое значение.

До PHP 8 функция могла вести себя непредсказуемо при передаче строки с именем группы. Теперь приведение типов выполняется корректно.

<?php
function changeGroupForSymlinks($directory, $group) {
    $iterator = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator($directory, FilesystemIterator::SKIP_DOTS),
        RecursiveIteratorIterator::SELF_FIRST
    );

    foreach ($iterator as $item) {
        if ($item->isLink()) {
            if (lchgrp($item->getPathname(), $group)) {
                echo 'Обработана ссылка: ' . $item->getPathname() . "\n";
            } else {
                echo 'Ошибка для: ' . $item->getPathname() . "\n";
            }
        }
    }
}

changeGroupForSymlinks('/path/to/dir', 'developers');
?>

Обработана ссылка: /path/to/dir/link1
Обработана ссылка: /path/to/dir/subdir/link2

<?php
function safeLchgrp($link, $group) {
    if (!is_link($link)) {
        throw new InvalidArgumentException("$link не является символической ссылкой.");
    }

    clearstatcache(true, $link);

    // Получение текущей группы ссылки
    $currentGid = filegroup($link);
    $targetGid = is_numeric($group) ? (int)$group : posix_getgrnam($group)['gid'] ?? null;

    if ($targetGid === null) {
        throw new InvalidArgumentException("Группа $group не существует.");
    }

    if ($currentGid === $targetGid) {
        return true; // Группа уже установлена
    }

    return lchgrp($link, $targetGid);
}

try {
    $result = safeLchgrp('project_link', 'www-data');
    echo $result ? 'Успешно' : 'Не удалось';
} catch (Exception $e) {
    echo 'Исключение: ' . $e->getMessage();
}
?>

Успешно

<?php
$link = 'config_link';
$group = 'staff';

// Сохранение текущих прав доступа ссылки
$originalPerms = fileperms($link) & 0777;

if (lchgrp($link, $group)) {
    // Восстановление прав доступа (если они были изменены системой)
    chmod($link, $originalPerms);
    echo "Группа изменена, права доступа сохранены.";
}
?>

Группа изменена, права доступа сохранены.

<?php
$link = 'secure_link';
$user = 'serveradmin';
$group = 'admins';

if (lchown($link, $user) && lchgrp($link, $group)) {
    echo 'Владелец и группа символической ссылки установлены.';
}
?>

Владелец и группа символической ссылки установлены.

Lchgrp в Python

Модуль os предоставляет функцию lchown(), которая может изменить и владельца, и группу символической ссылки.

import os
import pwd
import grp

link_path = 'my_symlink'
group_name = 'www-data'
gid = grp.getgrnam(group_name).gr_gid

os.lchown(link_path, -1, gid)  # -1 означает, что владелец не меняется
print(f"Группа для {link_path} изменена на {group_name}")

Группа для my_symlink изменена на www-data

В Node.js можно использовать метод lchown() из модуля fs.

const fs = require('fs').promises;

async function changeLinkGroup(linkPath, gid) {
    try {
        await fs.lchown(linkPath, -1, gid);
        console.log(`Группа ссылки ${linkPath} успешно изменена.`);
    } catch (err) {
        console.error('Ошибка:', err.message);
    }
}

changeLinkGroup('symlink.txt', 33);

Группа ссылки symlink.txt успешно изменена.

В командной строке Linux можно использовать утилиту chown с опцией -h.

chown -h :www-data symlink_name

# Команда не выводит сообщение при успешном выполнении