1X.5.2 ファイル操作(ユーティリティ)
コピー/リネーム/削除
| 構文 | 説明 |
|---|---|
int copy ( string source, string dest ) |
ファイルsource を dest にコピーします。 成功した場合に TRUE を、失敗した場合に FALSE を返します。 |
int rename ( string oldname, string newname ) |
oldname を newname にリネームしようと試みます。 成功した場合に TRUE を、失敗した場合に FALSE を返します。 |
bool unlink ( string filename [,resource context] ) |
filename を削除します。成功した場合に TRUE を、失敗した場合に FALSE を返します。 ディレクトリの削除には、rmdir()を使います。 |
一括読み込み
| 構文 | 説明 |
|---|---|
array file ( string filename [,int use_include_path [,resource context]] ) |
filename で指定されたファイルの各行から成る配列を返します。 各行には改行記号が含まれます。失敗すると file() は FALSE を返します。 引数 use_include_path に 1(またはTRUE) を設定することにより、 include_path からファイル検索を行うこともできます。 用例:
$lines = file ('http://www.y2sunlight.com/');
// 読み込んだHTMLを行番号を付けて表示します。
foreach ($lines as $line_num => $line) {
echo "Line #<b>{$line_num}</b> : " .
htmlspecialchars($line) . "<br>\n";
}
|
string file_get_contents ( string filename [,bool use_include_path [,resource context [,int offset]]] ) |
file() 関数と次の点を除いて同じです。この関数は PHP4.3 以降で使用できます。
|
int readfile ( string filename [,bool use_include_path [,resource context]] ) |
ファイルを読んで標準出力に書き出します。 ファイルから読み込んだバイト数を返します。 エラーが起こると FALSE を返します。 引数 use_include_path に 1 (またはTRUE) を設定することにより、 include_path からファイル検索を行うこともできます。 |
ファイル名取得
| 構文 | 説明 |
|---|---|
string basename ( string path [,string suffix] ) |
指定されたファイルパス path のベース名を返します。 suffix を指定した場合、ファイル名が suffix で終了していたら、この部分をカットして返します 。 用例:
basename("test/file.txt"); // 結果:'file.txt'
basename("test/file.txt",".txt"); // 結果:'file'
basename("test/file.txt",".php"); // 結果:'file.txt'
|
string dirname ( string path ) |
指定されたファイルパス path のディレクトリの名前を返します。 path に / が無い場合は、カレントディレクトリを示す . が返されます。 用例:
dirname("C:/test/file.txt"); // 結果:'C:/test' for Windows
dirname("/test/file.txt"); // 結果:'/test'
dirname("test/file.txt"); // 結果:'test'
dirname("file.txt"); // 結果:'.'
|
ファイル状態取得
| 構文 | 説明 |
|---|---|
bool file_exists ( string filename ) |
filename で指定したファイルまたはディレクトリ が存在すれば TRUE を返し、 そうでなければ FALSE を返します。 |
bool is_readable ( string filename ) |
filename が存在し、それが読み込み可能であれば TRUE を返します。 PHPは、Webサーバが実行されているユーザ ID('nobody' が多い) でファ イルにアクセスすることを覚えておいてください。 セーフモードの制限は働きません。 |
bool is_writable ( string filename ) |
filename が存在して、かつそれが書き込み可能で あれば TRUE を返します。 引数 filename はディレクトリ名とすることができ、ディレクトリが書き込み可能であることを調べることが可能です。 PHPは、Webサーバが実行されているユーザ ID('nobody' が多い) でファ イルにアクセスすることを覚えておいてください。 セーフモードの制限は働きません。 |
bool is_file ( string filename ) |
filename が存在して、かつそれが通常ファイルであれば TRUE を返します。 |
bool is_dir ( string filename ) |
filename が存在して、かつそれが ディレクトリであれば TRUE を返します。 |
string filetype ( string filename ) |
filename で指定されたファイルのタイプを文字列で返します。 エラーが発生すると FALSE を返します。返される文字列:
|
array stat ( string filename ) |
filename で指定されたファイルのステータス情報を含む配列を返します。エラーの場合は FALSE を返します。 ステータス情報を含む配列のフォーマットについては fstat()関数 を参照して下さい。 filename がシンボリックリンクの場合、シンボリックリンクではなくファイルの実体のステータスが返されます。 シンボリックリンクのステータスを取得する場合は、lstat() を使用します。 |
int fileatime ( string filename ) int filemtime ( string filename ) int filectime ( string filename ) |
fileatime() はfilename の最終アクセス時間を、filemtime() は最終修正時間を、 filectime() は最終INODE変更時間をUNIXタイムスタンプとして返されます。エラーの場合はFALSEを返します。 filemtime() はファイルの内容が変更された時間です。ファイルの更新日時を取得するには、 この値に date()関数 を適用します。 また、getlastmod() を使うとさらに便利です。 getlastmod() は自分自身(PHPスクリプト)の最終ページ更新時刻を返します。 |
