CLI utilities in PHP: creating console tools from scratch

CLI utilities in PHP: why haven't you written your console tool yet?

Imagine: you're sitting in the terminal, run one command — and in a second you have a ready report, all images are converted, or a project is set up on a new server. No browser, no mouse, no unnecessary movements. Sounds like magic? No, these are ordinary CLI utilities in PHP.

Many developers consider PHP only a "web language". But in fact, PHP is an excellent tool for creating console applications. It has built-in work with input-output streams, convenient argument handling, and, of course, powerful libraries like Symfony Console. In this article, we'll break down how to create a console script in PHP from scratch — from a simple echo to a full-fledged tool with colors and a progress bar.

If you're tired of doing repetitive tasks manually, if you want to automate routine and feel like a real hacker — you've come to the right place. Let's go!

What is a CLI utility and why do you need it?

CLI (Command Line Interface) is a program that works in the command line. It accepts arguments, performs actions, and outputs the result. Unlike web applications, there is no HTML, CSS, or JavaScript here. Only pure code and the terminal.

Why write CLI utilities in PHP? Here are a few scenarios:

\n
• Data migrations — transferring information from CSV to a database.
\n
• Report generation — collecting statistics and generating PDF or Excel.
\n
• Deployment automation — deploying a project on a server with one command.
\n
• Parsing and file processing — conversion, compression, renaming.
\n
• CRON tasks — regular operations that run on a schedule.
\n

And most importantly — developing console tools in PHP does not require complex infrastructure. One file and a few lines of code are enough.

Getting started: a minimal CLI script in PHP

Open your terminal, create a file hello.php and write:

<?php\necho "Hello, terminal!\\n";\n

Run it:

php hello.php\n

You will see:

Hello, terminal!

Congratulations! You've just written your first CLI utility in PHP. But let's make it useful. Let's add command line argument handling.

Working with arguments: $argv and $argc

PHP provides two superglobal arrays for working with the console: $argv (list of arguments) and $argc (number of arguments). The first argument (index 0) is the name of the script itself.

Example:

<?php\nif ($argc < 2) {\n    echo "Usage: php hello.php [name]\\n";\n    exit(1);\n}\n\n$name = $argv[1];\necho "Hello, $name!\\n";\n

Run:

php hello.php Alexey\n

Result:

Hello, Alexey!

Already interesting. But for serious projects, this approach is inconvenient. You need named arguments, flags, default values. This is where the Symfony Console library comes to the rescue.

Symfony Console: a powerful foundation for CLI utilities in PHP

Symfony Console is the de facto standard for creating console applications in PHP. With it, you can easily add:

\n
• Named arguments and options
\n
• Colored output
\n
• Progress bars
\n
• Input validation
\n
• Command autoloading
\n

Installation via Composer:

composer require symfony/console\n

Now let's create a full-fledged CLI utility in PHP — a password generator.

Writing a command for password generation

Project structure