【PHP8.x】is_writable関数の使い方
is_writable関数は、指定されたファイルやディレクトリがPHPスクリプトから書き込み可能であるかどうかをチェックする関数です。この関数は、引数として検証したいファイルまたはディレクトリのパスを文字列で受け取ります。もし指定されたパスが書き込み可能であればtrue（真）を返し、書き込み不可能であればfalse（偽）を返します。
この関数は、ファイルへのデータ書き込みや、ディレクトリ内に新しいファイルを作成するといった書き込み処理を行う前に、その処理が実際に成功するかどうかを事前に確認するために非常に役立ちます。例えば、ユーザーがアップロードしたファイルを保存するディレクトリが本当に書き込み可能か、あるいはログファイルを書き込むためのファイルが存在し、かつ書き込み権限があるかなどをプログラム実行時に検証することができます。
falseが返されるケースとしては、いくつかの状況が考えられます。一つは、指定されたファイルやディレクトリが存在しない場合です。また、たとえファイルやディレクトリが存在していても、PHPを実行しているユーザーアカウントに書き込み権限がない場合もfalseが返されます。さらに、ファイルシステム自体が読み取り専用（リードオンリー）でマウントされている場合など、OSレベルでの制約によっても書き込みができないことがあります。
この関数は、ファイル操作を伴うアプリケーションにおいて、予期せぬエラーを防ぎ、プログラムの堅牢性を高めるために利用されます。常にファイルやディレクトリの書き込み可否を確認することで、安全かつ安定したシステム運用に貢献します。
基本的な使い方
構文(syntax)
<?php
$file_path = 'path/to/your/file.txt';
$is_writable = is_writable($file_path);
?>
引数(parameters)
string $filename
- string $filename: 検査対象のファイルまたはディレクトリのパスを指定する文字列
戻り値(return)
bool
指定されたファイルやディレクトリが書き込み可能である場合は true を、そうでない場合は false を返します。