【PHP8.x】is_link関数の使い方

Copy
1<?php
2
3// 一時ファイルのパスを定義します
4$realFilePath = 'example_real_file.txt';
5$symlinkPath = 'example_symlink.txt';
6$nonExistentPath = 'non_existent_file.txt';
7
8// 1. 実際のファイルを作成します
9// このファイルは、シンボリックリンクのターゲットとして使用します。
10file_put_contents($realFilePath, 'This is a test content for the real file.');
11echo "Created a real file: '{$realFilePath}'\n";
12
13// 2. 作成したファイルへのシンボリックリンクを作成します
14// 注意: Windows環境では、管理者権限が必要な場合があります。
15// 失敗した場合でも、is_link()の動作は確認できますが、結果はfalseになります。
16$symlinkCreated = false; // シンボリックリンクが正常に作成されたかを示すフラグ
17if (symlink($realFilePath, $symlinkPath)) {
18    echo "Created a symbolic link: '{$symlinkPath}' pointing to '{$realFilePath}'\n";
19    $symlinkCreated = true;
20} else {
21    echo "Failed to create symbolic link: '{$symlinkPath}'. "
22         . "This might require administrator privileges or be unsupported by your filesystem.\n";
23    echo "is_link() for '{$symlinkPath}' will likely return false due to creation failure.\n";
24}
25
26echo "\n--- is_link() 関数の使用例 ---\n";
27
28// ケース1: シンボリックリンクをチェックします
29echo "Checking '{$symlinkPath}': ";
30if (is_link($symlinkPath)) {
31    echo "It IS a symbolic link.\n";
32} else {
33    echo "It is NOT a symbolic link. (Possible reasons: not a link, or link creation failed.)\n";
34}
35
36// ケース2: 通常のファイルをチェックします
37echo "Checking '{$realFilePath}': ";
38if (is_link($realFilePath)) {
39    echo "It IS a symbolic link.\n";
40} else {
41    echo "It is NOT a symbolic link.\n";
42}
43
44// ケース3: 存在しないファイルをチェックします
45echo "Checking '{$nonExistentPath}': ";
46if (is_link($nonExistentPath)) {
47    echo "It IS a symbolic link.\n";
48} else {
49    echo "It is NOT a symbolic link.\n";
50}
51
52echo "\n--- クリーンアップ ---\n";
53
54// テスト用に作成したファイルを削除します
55if (file_exists($realFilePath)) {
56    unlink($realFilePath);
57    echo "Removed '{$realFilePath}'.\n";
58}
59// シンボリックリンクが正常に作成されていた場合のみ削除します
60if ($symlinkCreated && file_exists($symlinkPath)) {
61    unlink($symlinkPath);
62    echo "Removed '{$symlinkPath}'.\n";
63}
64
65?>

PHPのis_link関数は、指定されたファイルパスがシンボリックリンクであるかどうかを判定するために使用されます。引数には、チェックしたいファイルやディレクトリのパスを文字列（string $filename）として渡します。この関数は真偽値（bool）を戻り値として返し、指定されたパスがシンボリックリンクであればtrueを、通常のファイル、ディレクトリ、または存在しないパスであればfalseを返します。

サンプルコードでは、まずexample_real_file.txtという実際のファイルを作成し、次にそれへのシンボリックリンクexample_symlink.txtを作成しています。特にWindows環境では、シンボリックリンクの作成（symlink関数）に管理者権限が必要となる場合があるため、作成に失敗する可能性もあります。

is_link関数の具体的な挙動として、作成されたシンボリックリンクexample_symlink.txtをチェックするとtrueが返されます。これに対し、通常のファイルであるexample_real_file.txtや、存在しないパスnon_existent_file.txtをチェックした場合は、いずれもfalseが返されることが確認できます。このようにis_link関数は、ファイルシステム上でシンボリックリンクを正確に識別するために利用できます。