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

作成日: 更新日:

is_writeable関数は、指定されたファイルまたはディレクトリが書き込み可能であるかを確認する関数です。この関数は、引数として検証したいファイルまたはディレクトリのパスを文字列で受け取ります。そして、そのパスが指し示す対象に対して、現在PHPスクリプトを実行しているユーザーが書き込み権限を持っているかどうかを評価し、結果を真偽値(trueまたはfalse)で返します。

もしis_writeable関数がtrueを返した場合、それはそのファイルにデータを書き込んだり、ディレクトリ内に新しいファイルやサブディレクトリを作成したりする操作が現在のPHPスクリプトによって可能であることを意味します。逆にfalseが返された場合は、書き込み操作が許可されていないため、試みても失敗するか、エラーが発生する可能性が高いです。

この関数は、ファイルアップロード機能の実装や、ログファイルの保存先が適切であるかの確認など、ファイルシステムに対する書き込み操作を行う前にその準備状況をチェックする際に非常に有用です。事前に書き込み可能性を確認することで、不必要なエラーを回避し、より安定したアプリケーションを構築することができます。ファイルやディレクトリが存在しない場合や、パスが不正な場合もfalseを返すことに注意が必要です。書き込み権限は、オペレーティングシステムの設定(パーミッションなど)に依存します。

基本的な使い方

構文(syntax)

<?php
$filepath = 'path/to/your/file.txt';
$isWritable = is_writeable($filepath);
?>

引数(parameters)

string $filename

  • string $filename: 書き込み権限を確認したいファイルまたはディレクトリのパスを指定する文字列

戻り値(return)

bool

指定されたファイルまたはディレクトリへの書き込みが可能かどうかを判定し、真偽値(trueまたはfalse)を返します。

【PHP8.x】is_writeable関数の使い方 | いっしー@Webエンジニア