PHP マニュアル
前のページ |  | 次のページ

# XL. ファイルシステム関数

# 導入

# 要件

この拡張モジュールを構築するには外部ライブラリを必要としませんが、 Linux 上で LFS (ラージファイル) をサポートする PHP を希望する場合は、 最新の glibc を入手し、次のコンパイラフラグ `-D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64` を付けて PHP をコンパイルする必要があります。

# インストール手順

PHP コアに含まれるため、 追加のインストール無しで使用できます。

# 実行時設定

`php.ini` の設定により動作が変化します。

表 1. ファイルシステムおよびストリーム設定オプション

名前 | デフォルト | 変更の可否 | 変更履歴
--- | --- | --- | ---
allow_url_fopen | "1" | PHP_INI_SYSTEM | PHP_INI_ALL は PHP <= 4.3.4 で利用可能です。 PHP 4.0.4 から利用可能です。
allow_url_include | "0" | PHP_INI_SYSTEM | PHP 5.2.0 から利用可能です。
user_agent | NULL | PHP_INI_ALL | PHP 4.3.0 から利用可能です。
default_socket_timeout | "60" | PHP_INI_ALL | PHP 4.3.0 から利用可能です。
from | "" | PHP_INI_ALL |
auto_detect_line_endings | "0" | PHP_INI_ALL | PHP 4.3.0 から利用可能です。

以下に設定ディレクティブに関する 簡単な説明を示します。

`allow_url_fopen` boolean

  このオプションにより、URL対応のfopenラッパーが使用可能となり、 ファイルのようにURLオブジェクトをアクセスできるようになります。 デフォルトのラッパーが、ftpまたはhttpプロトコルを用いて リモートファイルに アクセスするために提供されています。zlibのようないくつかの拡張モジュールが ラッパーを追加することがあります。

  > 注意: この設定はセキュリティ上の理由で php.ini 中でのみ設定可能です。

  > 注意: このオプションは、バージョン4.0.3のリリース直後に追加されました。 4.0.3を含む以前のバージョンでは、この機能は、設定スイッチ `--disable-url-fopen-wrapper`を使用することに より、コンパイル時にのみ無効にすることができます。

  警告
  PHP 4.3より前のWindows版では、以下の関数は、リモートファイルの アクセスをサポートしません。: include(), include_once(), require(), require_once(), 参照LXIII, イメージ関数(image) 拡張モジュールの imagecreatefromXXX

`allow_url_include` boolean

  このオプションを指定すると include()、include_once()、 require()、require_once() で URL 対応の fopen ラッパーが使用できるようになります。

  > 注意: この設定を使用するには、allow_url_fopen が on でないといけません。

`user_agent` string

  送信する PHP 用のユーザエージェントを定義します。

`default_socket_timeout` integer

  ソケットベースのストリームのデフォルトの有効時間(単位は秒)を定義します。

  > 注意: この設定は、PHP 4.3で追加されました。

`from` string

  匿名ftp用パスワード(自分のemailアドレス)を定義します。

`auto_detect_line_endings` boolean

  onにした場合、PHPは fgets() および file() により読み込まれたデータを評価し、UNIX、MS-DOS、Machintoshの行末 表記を使用しているかどうかを調べます。

  これにより、PHPがMacintoshシステムと相互運用できるようになりますが、 デフォルトはOffとなっています。これは、最初の行の行末表記を検出 する際にごく僅かな性能劣化があるためと、UNIXシステムのもとで復改 文字を項目セパレータとして使用している人が従来のバージョンと互換 性がない動作であると感じる可能性があるためです。

  > 注意: この設定オプションは、PHP 4.3で追加されました。

# リソース型

# 定義済み定数

以下の定数が定義されています。 この関数の拡張モジュールが PHP 組み込みでコンパイルされているか、 実行時に動的にロードされている場合のみ使用可能です。

`GLOB_BRACE` (integer)

`GLOB_ONLYDIR` (integer)

`GLOB_MARK` (integer)

`GLOB_NOSORT` (integer)

`GLOB_NOCHECK` (integer)

`GLOB_NOESCAPE` (integer)

`PATHINFO_DIRNAME` (integer)

`PATHINFO_BASENAME` (integer)

`PATHINFO_EXTENSION` (integer)

`PATHINFO_FILENAME` (integer)

  PHP 5.2.0 以降。

`FILE_USE_INCLUDE_PATH` (integer)

`FILE_APPEND` (integer)

`FILE_IGNORE_NEW_LINES` (integer)

`FILE_SKIP_EMPTY_LINES` (integer)

# 参考

関連する関数については、ディレクトリ およびプログラム実行の節を 参照してください。

リモートファイルとして使用することができる種々のURLラッパーの一覧 と説明については、付録Mも参照してください。

前のページ | ホーム | 次のページ
filepro | 上に戻る | basename