getcwd

関数の概要

PHPの getcwd 関数は、現在スクリプトが実行されている作業ディレクトリ（カレントディレクトリ）のパスを取得するための関数です。ディレクトリ操作を行う際に、現在の場所を知ることは非常に重要で、ファイルの読み書きや移動パスの基準として活用されます。

パラメータの説明

  • パラメータなし – getcwd は引数を取りません。

戻り値

getcwd は現在の作業ディレクトリの絶対パスを文字列で返します。取得に失敗した場合は false を返します。

使用例

基本的な使い方

<?php
echo getcwd();
?>

このコードを実行すると、現在の作業ディレクトリのパスが画面に表示されます。例えば、/var/www/html のような形です。

ディレクトリ変更後の確認

<?php
chdir('/tmp');
echo getcwd();
?>

まず chdir() を使って作業ディレクトリを変更し、その後に getcwd() でどのディレクトリになっているかを表示しています。この例だと /tmp が出力されます。

ディレクトリパスを変数に保存してファイル操作に活用

<?php
$currentDir = getcwd();
$filePath = $currentDir . '/data.txt';

if (file_exists($filePath)) {
    echo 'ファイルは存在します。パス: ' . $filePath;
} else {
    echo 'ファイルは存在しません。';
}
?>

作業ディレクトリを取得して変数に保存し、そのパスを使ってファイルの存在チェックを行っています。実務的な用途にも便利です。

関連する関数

  • chdir() – 作業ディレクトリを変更する関数
  • dirname() – パスの親ディレクトリを取得する関数
  • realpath() – パスを正規化して絶対パスを返す関数
  • getenv() – 環境変数からディレクトリ情報を取得可能

まとめ

getcwd は現在の作業ディレクトリを簡単に取得することができる便利な関数です。引数は不要で、絶対パスを文字列で返します。ファイルのパス指定やディレクトリの移動の把握など、PHPでディレクトリ操作を行う際には欠かせない基本関数の一つです。是非、今回紹介した使い方を参考にしてみてください。

スポンサーリンク