カテゴリ: PHP 更新日: 2026/03/21

PHPのCLIスクリプト作成方法を完全解説!初心者でもわかるコマンドライン入門

PHP の CLI スクリプトの作成方法
PHP の CLI スクリプトの作成方法

先生と生徒の会話形式で理解しよう

生徒

「PHPって、ブラウザで動かすものだと思っていました。黒い画面でも使えるんですか?」

先生

「使えますよ。PHPはコマンドラインという画面から直接実行できます。」

生徒

「コマンドラインって、文字だけの画面ですよね?パソコン初心者でも大丈夫ですか?」

先生

「大丈夫です。電卓のボタンを順番に押す感覚で、ゆっくり覚えていきましょう。」

1. PHPのCLIスクリプトとは?

1. PHPのCLIスクリプトとは?
1. PHPのCLIスクリプトとは?

PHPのCLIスクリプトとは、コマンドラインと呼ばれる文字だけの画面で動かすPHPプログラムのことです。コマンドラインは、Windowsでは「コマンドプロンプト」や「PowerShell」と呼ばれています。マウスを使わず、文字を入力してパソコンに命令を出す場所です。

例えるなら、リモコンではなく声で家電に指示を出すようなものです。PHPのCLIスクリプトを使うと、ブラウザを開かずに、PHPファイルを直接実行できます。バッチ処理や自動処理、学習用の簡単な動作確認によく使われます。

2. PHPをコマンドラインで使う準備

2. PHPをコマンドラインで使う準備
2. PHPをコマンドラインで使う準備

PHPのCLIスクリプトを動かすには、まずPHPがパソコンに入っている必要があります。これは「アプリをインストールする」感覚と同じです。PHPをインストールすると、「php」という命令が使えるようになります。

コマンドラインで「php」と入力して反応があれば準備完了です。反応があるとは、エラーではなく文字が表示される状態を指します。この状態になると、PHPのCLI環境が使えるようになります。

CLIは「Command Line Interface」の略で、文字で操作する仕組みという意味です。難しく聞こえますが、やっていることは「命令を書いて実行する」だけです。

3. 最初のPHP CLIスクリプトを作ってみよう

3. 最初のPHP CLIスクリプトを作ってみよう
3. 最初のPHP CLIスクリプトを作ってみよう

まずは、PHPのCLIスクリプト用のファイルを作ります。ファイル名は「test.php」など、最後が「.php」になっていれば大丈夫です。これは「これはPHPですよ」とパソコンに伝える目印です。


<?php
echo "こんにちは、PHP CLI!";

このコードは、「こんにちは、PHP CLI!」という文字を表示するだけの、とてもシンプルなプログラムです。echoは「表示する」という意味の命令です。

コマンドラインでファイルのある場所に移動し、次のように入力します。


php test.php

すると、次のように表示されます。


こんにちは、PHP CLI!

4. 文字を変数に入れて表示してみよう

4. 文字を変数に入れて表示してみよう
4. 文字を変数に入れて表示してみよう

次は変数を使います。変数とは、箱のようなもので、文字や数字を一時的に入れておく場所です。名前付きの箱だと思うと分かりやすいです。


<?php
$message = "PHPは楽しい";
echo $message;

$messageという箱に文字を入れて、それを表示しています。ドル記号から始まるのがPHPの変数の特徴です。


PHPは楽しい

5. コマンドラインから文字を受け取る

5. コマンドラインから文字を受け取る
5. コマンドラインから文字を受け取る

PHPのCLIスクリプトでは、実行するときに文字を渡すことができます。これは「実行時引数」と呼ばれます。少し難しい言葉ですが、「後から渡すメモ」くらいの感覚で大丈夫です。


<?php
$name = $argv[1];
echo "こんにちは、".$name;

$argvは、コマンドラインから渡された情報が入っている配列です。配列とは、番号付きの箱が並んでいるものです。


php test.php 太郎

こんにちは、太郎

6. 条件によって処理を変えるCLIスクリプト

6. 条件によって処理を変えるCLIスクリプト
6. 条件によって処理を変えるCLIスクリプト

CLIスクリプトでも、条件によって動きを変えられます。ここで使うのがif文です。これは「もし〜なら」という判断をする命令です。


<?php
$number = 10;

if ($number > 5) {
  echo "5より大きいです";
}

5より大きいです

7. CLIスクリプトが活躍する場面

7. CLIスクリプトが活躍する場面
7. CLIスクリプトが活躍する場面

PHPのCLIスクリプトは、毎日同じ作業を自動で行いたいときに便利です。例えば、決まった時間にデータを整理したり、文字をまとめて処理したりする場面です。

画面を表示しないため、処理が軽く、パソコンへの負担も少なくなります。これは、裏方で黙々と働くロボットのような存在です。

8. 初心者がつまずきやすいポイント

8. 初心者がつまずきやすいポイント
8. 初心者がつまずきやすいポイント

初心者の方がよく困るのは、「ファイルの場所が分からない」「コマンドラインが怖い」という点です。ですが、失敗してもパソコンが壊れることはありません。

エラーが出た場合は、「ここが間違っていますよ」というお知らせだと思ってください。CLIスクリプトは、間違いに気づきやすく、学習にとても向いています。

コメント
コメント投稿は、ログインしてください

まだ口コミはありません。

カテゴリの一覧へ
新着記事
New1
PHP
PHPのCLIスクリプト作成方法を完全解説!初心者でもわかるコマンドライン入門
New2
PHP
PHP のエラー種類を完全ガイド!初心者でも理解できる Notice・Warning・Fatal Error の違い
New3
Python
Pythonの辞書をファイルに保存・読み込む方法(pickle / json)初心者向け完全ガイド
New4
PHP
PHPの関数型プログラミングの基礎をやさしく解説!初心者でもわかる書き方と考え方
人気記事
No.1
Java&Spring記事人気No1
PHP
PHP の型変換を完全ガイド!初心者でもわかる明示的変換・自動変換
No.2
Java&Spring記事人気No2
Python
Pythonで辞書のネスト構造(入れ子辞書)を扱う方法 初心者向け完全ガイド
No.3
Java&Spring記事人気No3
Python
Pythonでディレクトリを作成・削除・一覧表示する方法!初心者向けにosとpathlibを使った使い方を解説
No.4
Java&Spring記事人気No4
PHP
PHPの特殊文字とエスケープ処理を完全ガイド!初心者向けにhtmlspecialcharsとhtmlentitiesをやさしく解説
No.5
Java&Spring記事人気No5
PHP
PHP の基本構文(開始タグ・コメント・インデント)を完全ガイド!初心者向け解説
No.6
Java&Spring記事人気No6
Python
Pythonでリストを分割する方法(スライス / split() / itertools)
No.7
Java&Spring記事人気No7
Python
Pythonの例外を発生させる方法を完全解説!raise文の使い方を初心者向けにやさしく説明
No.8
Java&Spring記事人気No8
Python
Pythonの辞書をファイルに保存・読み込む方法(pickle / json)初心者向け完全ガイド