PHPのis_writable()関数とは？使い方とサンプルコードをわかりやすく解説

is_writable() 関数は、指定したファイルが書き込み可能かどうかを判定するPHPの組み込み関数です。ファイルが存在し、かつ書き込み権限がある場合に TRUE を返します。

基本構文

is_writable(file_path)

パラメータ

• file_path（必須）− 書き込み可能かどうかを確認したいファイルへのパスを文字列で指定します。

戻り値

次の場合に TRUE を返します。

• ファイルが存在する
• そのファイルに対して書き込み権限がある

上記以外の場合（ファイルが存在しない、読み取り専用など）は FALSE を返します。

使用例1：シンプルな書き込み可否チェック

<?php
$file = "one.txt";
if(is_writable($file)) {
   echo ("File is writeable!");
} else {
   echo ("File is not writeable!");
}
?>

出力結果

File is not writeable!

この例では「one.txt」に書き込み権限がないため、else 側の処理が実行されています。

使用例2：ファイルパーミッションと合わせて確認する

続いて、fileperms() 関数と組み合わせて、パーミッション情報を表示しながら書き込み可否を確認する例を見てみましょう。

<?php
$file_permissions = fileperms("two.txt");
$res = sprintf("%o", $file_permissions);
$file = "two.txt";
if(is_writable($file)) {
   echo ("File is writeable!");
   echo("Permission = $res");
} else {
   echo ("File is not writeable!");
   echo("Permission = $res");
}
?>

出力結果

File is writeable!
Permission: 0777

この例では「two.txt」のパーミッションが「0777」（すべてのユーザーに読み書き実行が許可されている状態）であるため、is_writable() は TRUE を返しています。

まとめ

is_writable() 関数を使うことで、ファイルへの書き込み処理を実行する前に事前に権限をチェックできます。ログファイルへの追記や設定ファイルの更新など、書き込み操作を行う前のエラーチェックとして活用すると、予期しないエラーを防ぐことができます。