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

Примеры использования filegroup

<?php
$filename = 'test.txt';
$group_id = filegroup($filename);

if ($group_id !== false) {
    echo "Группа файла: $group_id";
} else {
    echo "Не удалось получить информацию о группе";
}
?>

Группа файла: 1000

<?php
$filename = 'config.php';
$gid = filegroup($filename);

if ($gid !== false) {
    $group_info = posix_getgrgid($gid);
    if ($group_info) {
        echo "Имя группы: " . $group_info['name'] . "\n";
        echo "ID группы: $gid";
    }
} else {
    echo "Ошибка получения информации";
}
?>

Имя группы: www-data
ID группы: 33

<?php
$result = filegroup('nonexistent.txt');
var_dump($result);
?>

bool(false)

Альтернативные функции в PHP

Функция stat() возвращает массив с полной статистикой о файле, включая информацию о группе.

<?php
$info = stat('index.php');
echo "ID группы: " . $info[5]; // Элемент с индексом 5 содержит gid
?>

Объектно-ориентированный подход через класс SplFileInfo.

<?php
$fileInfo = new SplFileInfo('script.php');
echo "Группа: " . $fileInfo->getGroup();
?>

Когда использовать:

• filegroup() - когда нужен только ID группы
• stat() - при необходимости получить несколько характеристик файла одновременно
• SplFileInfo - в объектно-ориентированном коде или при работе с несколькими свойствами файла

Типичные ошибки

<?php
// Ошибка: не проверяется существование файла
$group = filegroup('missing_file.txt');
echo "Группа: $group"; // Выведет пустоту или предупреждение
?>

Warning: filegroup(): stat failed for missing_file.txt in ...
Группа:

<?php
$group = filegroup('some_file.txt');

// Ошибочная проверка
if ($group) { // Может быть 0 (валидный ID группы)
    echo "Группа найдена";
} else {
    echo "Группа не найдена"; // Сработает для ID=0
}

// Правильная проверка
if ($group !== false) {
    echo "Группа: $group";
}
?>

<?php
// На Windows всегда возвращается 0
$group = filegroup('file.txt');
echo "На Windows группа всегда: $group";
?>

Изменения в версиях PHP

Функция filegroup() остается стабильной в течение многих версий PHP. В PHP 8.0 не было внесено значительных изменений в работу этой функции. Однако в PHP 8 улучшена обработка ошибок и строгость типов.

• Более строгая проверка типов аргументов
• Улучшенные сообщения об ошибках
• Функция продолжает возвращать int|false как и в предыдущих версиях

При переходе с PHP 7 на PHP 8 работа с filegroup() не требует изменений в коде при условии корректной обработки возвращаемых значений.

Расширенные примеры

<?php
function findFilesByGroup($directory, $targetGroup) {
    $results = [];
    $iterator = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator($directory)
    );

    foreach ($iterator as $file) {
        if ($file->isFile()) {
            $group = filegroup($file->getPathname());
            if ($group === $targetGroup) {
                $results[] = $file->getPathname();
            }
        }
    }
    return $results;
}

// Использование
$wwwFiles = findFilesByGroup('/var/www', 33);
echo "Файлы группы www-data:\n";
print_r($wwwFiles);
?>

<?php
class FileGroupMonitor {
    private $fileGroups = [];

    public function snapshot($directory) {
        $files = glob($directory . '/*');
        foreach ($files as $file) {
            $this->fileGroups[$file] = filegroup($file);
        }
    }

    public function checkChanges($directory) {
        $changes = [];
        $files = glob($directory . '/*');
        
        foreach ($files as $file) {
            $currentGroup = filegroup($file);
            if (isset($this->fileGroups[$file]) && 
                $this->fileGroups[$file] !== $currentGroup) {
                $changes[$file] = [
                    'old' => $this->fileGroups[$file],
                    'new' => $currentGroup
                ];
            }
        }
        return $changes;
    }
}

$monitor = new FileGroupMonitor();
$monitor->snapshot('/tmp');
// ... после некоторых изменений
$changes = $monitor->checkChanges('/tmp');
print_r($changes);
?>

<?php
class CachedFileGroup {
    private static $cache = [];
    private static $ttl = 300; // 5 минут

    public static function getGroup($filename) {
        $key = md5($filename);
        $now = time();
        
        if (isset(self::$cache[$key]) && 
            ($now - self::$cache[$key]['time']) < self::$ttl) {
            return self::$cache[$key]['group'];
        }
        
        $group = filegroup($filename);
        if ($group !== false) {
            self::$cache[$key] = [
                'group' => $group,
                'time' => $now
            ];
        }
        return $group;
    }

    public static function clearCache() {
        self::$cache = [];
    }
}

// Использование с кэшированием
for ($i = 0; $i < 10; $i++) {
    $group = CachedFileGroup::getGroup('large_file.dat');
    echo "Группа: $group\n";
}
?>

<?php
function checkGroupAccess($filename, $allowedGroups) {
    $fileGroup = filegroup($filename);
    if ($fileGroup === false) {
        return false;
    }
    
    $currentGroup = posix_getgid();
    $userGroups = posix_getgroups();
    
    // Проверяем, входит ли группа файла в разрешенные
    if (in_array($fileGroup, $allowedGroups)) {
        return true;
    }
    
    // Проверяем, совпадает ли с текущей группой пользователя
    if ($fileGroup === $currentGroup) {
        return true;
    }
    
    // Проверяем дополнительные группы пользователя
    return in_array($fileGroup, $userGroups);
}

// Пример использования
$hasAccess = checkGroupAccess('secure_config.ini', [33, 1000]);
echo $hasAccess ? "Доступ разрешен" : "Доступ запрещен";
?>

Аналоги в других языках программирования

Filegroup в Python

Модуль os предоставляет функцию stat(), возвращающую объект с информацией о файле.

import os
stat_info = os.stat('file.txt')
print(f"Group ID: {stat_info.st_gid}")
import grp
group_name = grp.getgrgid(stat_info.st_gid).gr_name
print(f"Group name: {group_name}")

Group ID: 1000
Group name: users

Используется асинхронный вызов через fs.stat.

const fs = require('fs');
fs.stat('file.txt', (err, stats) => {
    if (!err) {
        console.log(`Group ID: ${stats.gid}`);
    }
});
// Синхронная версия
const stats = fs.statSync('file.txt');
console.log(stats.gid);

stat -c '%g' filename.txt  # Только ID группы
ls -l filename.txt | awk '{print $4}'  # Имя группы