カテゴリ: 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
Python
PythonでREST APIを作る方法!初心者向けFastAPI入門|Python API開発の基本
New2
PHP
PHPのコード品質向上ツール完全解説!PHPStan(ピーエイチピースタン)とPHPCS(ピーエイチピーシーエス)で初心者でも安全にデバッグしよう
New3
Python
Pythonでデータベースのログを記録・監視する方法を完全解説!初心者向けデータベースログ管理入門
New4
PHP
PHPのログファイルを活用したエラートラッキング完全ガイド|初心者でもわかるPHPデバッグ入門
人気記事
No.1
Java&Spring記事人気No1
PHP
PHP のフォームデータの受け取り($_POST, $_GET)を完全解説!初心者向けガイド
No.2
Java&Spring記事人気No2
Python
Pythonのインストール&環境構築!Windows・Mac・Linuxでの手順を初心者向けに解説
No.3
Java&Spring記事人気No3
Python
PythonでExcelファイル(.xlsx)を操作する方法を徹底解説!初心者でもできるopenpyxl・pandasの使い方
No.4
Java&Spring記事人気No4
Python
Pythonのコンストラクタ(__init__)の使い方!初心者でもわかるオブジェクトの初期化
No.5
Java&Spring記事人気No5
Python
Pythonでテキストファイルを1行ずつ読み込む方法(readline() / readlines())
No.6
Java&Spring記事人気No6
PHP
PHPの特殊文字とエスケープ処理を完全ガイド!初心者向けにhtmlspecialcharsとhtmlentitiesをやさしく解説
No.7
Java&Spring記事人気No7
Python
Pythonでデータベースの接続プールを使う方法を徹底解説!初心者向けPythonデータベース接続プール入門
No.8
Java&Spring記事人気No8
PHP
PHPのPHPUnitを使った単体テスト完全ガイド!初心者でもわかるテストとデバッグ入門