「PHP」filegroup関数の使い方 – ファイルのグループIDを取得する方法

こんにちは！今回はPHPのfilegroup関数について詳しく解説します。この関数は、ファイルの所有グループIDを取得するために使用されます。

1. 基本的な使い方
2. 実践的な使用例
3. エラーハンドリング
4. セキュリティチェック
5. 権限変更の例
まとめ

1. 基本的な使い方

// ファイルのグループIDを取得
$filename = 'example.txt';
$groupId = filegroup($filename);

if ($groupId !== false) {
    echo "ファイルのグループID: " . $groupId;
} else {
    echo "グループIDの取得に失敗しました";
}

2. 実践的な使用例

2-1. ファイルの詳細情報取得

function getFileDetails($filename) {
    if (!file_exists($filename)) {
        throw new Exception("ファイルが存在しません");
    }

    return [
        'filename' => basename($filename),
        'group_id' => filegroup($filename),
        'owner_id' => fileowner($filename),
        'permissions' => fileperms($filename),
        'size' => filesize($filename),
        'type' => filetype($filename)
    ];
}

try {
    $details = getFileDetails('test.txt');
    print_r($details);
} catch (Exception $e) {
    echo "エラー: " . $e->getMessage();
}

2-2. グループ名の取得

function getFileGroupInfo($filename) {
    try {
        $groupId = filegroup($filename);
        if ($groupId === false) {
            throw new Exception("グループIDの取得に失敗しました");
        }

        // グループ情報の取得
        $groupInfo = posix_getgrgid($groupId);
        if ($groupInfo === false) {
            throw new Exception("グループ情報の取得に失敗しました");
        }

        return [
            'group_id' => $groupId,
            'group_name' => $groupInfo['name'],
            'members' => $groupInfo['members']
        ];

    } catch (Exception $e) {
        error_log($e->getMessage());
        return false;
    }
}

2-3. ディレクトリ内のファイル権限チェック

function checkDirectoryPermissions($directory) {
    $results = [];
    $files = scandir($directory);

    foreach ($files as $file) {
        if ($file === '.' || $file === '..') {
            continue;
        }

        $fullPath = $directory . '/' . $file;
        $groupId = filegroup($fullPath);

        $results[] = [
            'file' => $file,
            'group_id' => $groupId,
            'readable' => is_readable($fullPath),
            'writable' => is_writable($fullPath),
            'executable' => is_executable($fullPath)
        ];
    }

    return $results;
}

3. エラーハンドリング

function safeGetGroupInfo($filename) {
    try {
        // ファイルの存在確認
        if (!file_exists($filename)) {
            throw new Exception("ファイルが存在しません");
        }

        // 読み取り権限の確認
        if (!is_readable($filename)) {
            throw new Exception("ファイルを読み取れません");
        }

        // グループIDの取得
        $groupId = filegroup($filename);
        if ($groupId === false) {
            throw new Exception("グループIDの取得に失敗しました");
        }

        return $groupId;

    } catch (Exception $e) {
        error_log("Error in safeGetGroupInfo: " . $e->getMessage());
        return false;
    }
}

4. セキュリティチェック

function checkFilePermissions($filename) {
    $warnings = [];

    $groupId = filegroup($filename);
    $perms = fileperms($filename);

    // グループ権限のチェック
    if ($perms & 0x0010) {
        $warnings[] = "グループに対して実行権限が設定されています";
    }
    if ($perms & 0x0002) {
        $warnings[] = "グループに対して書き込み権限が設定されています";
    }

    return [
        'group_id' => $groupId,
        'permissions' => sprintf('%o', $perms),
        'warnings' => $warnings
    ];
}

5. 権限変更の例

function updateFileGroup($filename, $newGroupId) {
    try {
        // 現在のグループIDを取得
        $currentGroupId = filegroup($filename);
        if ($currentGroupId === false) {
            throw new Exception("現在のグループIDの取得に失敗しました");
        }

        // グループの変更
        if (!chgrp($filename, $newGroupId)) {
            throw new Exception("グループの変更に失敗しました");
        }

        return [
            'success' => true,
            'old_group' => $currentGroupId,
            'new_group' => $newGroupId
        ];

    } catch (Exception $e) {
        error_log($e->getMessage());
        return [
            'success' => false,
            'error' => $e->getMessage()
        ];
    }
}