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

Copy
1<?php
2
3/**
4 * ファイルシステムのハードリンクを作成します。
5 * 既存のファイルへの新しいパスを作成し、その新しいパス（リンク名）で元のファイルと同じコンテンツにアクセスできるようにします。
6 * これはWebページのハイパーリンクとは異なり、ファイルシステムレベルで機能します。
7 *
8 * @param string $target 元となるファイルパス (例: 'source.php')
9 * @param string $link 作成する新しいリンクのファイルパス (例: 'another_page.php')
10 * @return bool 成功した場合は true、失敗した場合は false
11 */
12function createPageLink(string $target, string $link): bool
13{
14    // ターゲットファイルが存在するか確認します
15    if (!file_exists($target)) {
16        echo "エラー: ターゲットファイル '{$target}' が見つかりません。\n";
17        return false;
18    }
19
20    // 作成しようとしているリンク名が既に存在するか確認します
21    if (file_exists($link)) {
22        echo "エラー: リンク名 '{$link}' は既に存在します。上書きは行いません。\n";
23        return false;
24    }
25
26    // link() 関数を使用してハードリンクを作成します
27    if (link($target, $link)) {
28        echo "ハードリンク '{$link}' を '{$target}' に作成しました。\n";
29        // これにより、Webサーバー経由で '{$link}' にアクセスすると '{$target}' と同じ内容が表示されます。
30        return true;
31    } else {
32        echo "エラー: ハードリンク '{$link}' の作成に失敗しました。\n";
33        return false;
34    }
35}
36
37// --- サンプルコードの実行例 ---
38
39// ハードリンクの元となるターゲットファイルを作成します
40$targetFileName = 'original_content.php';
41// ファイルにPHPコードを書き込みます
42file_put_contents($targetFileName, '<?php echo "これは元のページの内容です。"; ?>');
43echo "ターゲットファイル '{$targetFileName}' を作成しました。\n";
44
45// このターゲットファイルへのハードリンクを作成します
46// これにより、'another_page.php' という名前で 'original_content.php' と同じ内容にアクセスできるようになります
47$linkedPageName = 'another_page_link.php';
48$success = createPageLink($targetFileName, $linkedPageName);
49
50// リンク作成が成功した場合、Webサーバーでの動作についてヒントを表示します
51if ($success) {
52    echo "Webサーバーを起動し、ブラウザで 'http://localhost/{$linkedPageName}' (またはあなたのWebサーバー設定に応じたパス) にアクセスしてみてください。\n";
53    echo "表示される内容は '{$targetFileName}' に直接アクセスした場合と同じです。\n";
54}
55
56// --- クリーンアップ (オプション) ---
57// サンプルコード実行後に作成したファイルを削除する場合は、以下の行のコメントを解除してください。
58// 実際のシステムでは、作成したファイルを自動で削除することは通常ありません。
59// if (file_exists($targetFileName)) {
60//     unlink($targetFileName);
61//     echo "ターゲットファイル '{$targetFileName}' を削除しました。\n";
62// }
63// if (file_exists($linkedPageName)) {
64//     unlink($linkedPageName);
65//     echo "リンクファイル '{$linkedPageName}' を削除しました。\n";
66// }
67
68?>

PHPのlink関数は、ファイルシステム上でハードリンクを作成するための関数です。ハードリンクとは、既存のファイルに新しい名前（パス）を割り当てることで、両方のパスからディスク上の同じコンテンツにアクセスできるようにする仕組みです。これはWebページ間のハイパーリンクとは異なり、ファイルシステムレベルで動作します。

引数$targetにはハードリンクの元となる既存のファイルパスを、$linkには新しく作成するハードリンクのファイルパスを指定します。関数が成功した場合はtrueが、失敗した場合はfalseが戻り値として返されます。

サンプルコードでは、createPageLink関数を使ってlink関数の利用方法を示しています。まずoriginal_content.phpというPHPファイルを生成し、そのファイル内容を記述します。次に、another_page_link.phpという名前でoriginal_content.phpへのハードリンクを作成します。このリンクが成功すると、Webサーバー経由でanother_page_link.phpにアクセスした場合、original_content.phpと全く同じ内容が表示されます。これは、ファイルシステムの観点から両方のファイルパスが同じ物理的なデータブロックを指しているためで、これにより、複数の異なる名前で同じコンテンツを効率的に提供することが可能です。