Skip to content
Greg Bowler edited this page Apr 20, 2026 · 2 revisions

phpgt/gtcommand provides the gt command used throughout PHP.GT projects to create applications, scaffold files, and run common development tasks from one place.

Most of the time we do not think about this package on its own. We use gt create to start a new WebEngine application, gt add to add files to it, and gt run while developing locally. This component is the layer that ties those workflows together.

Note

In WebEngine projects, this package is the command-line entry point for several other PHP.GT components. Commands such as gt serve, gt build, gt cron, and gt migrate are provided by this repository, but they are powered by separately maintained packages.

What this library covers

  • Creating a new WebEngine application from a blueprint.
  • Adding page, API, and cron files from built-in or project templates.
  • Running the local development server on its own or alongside build and cron watchers.
  • Exposing the Build, Cron, Database migration, and Server CLI commands through one entry point.
  • Giving WebEngine projects a consistent gt ... workflow instead of several separate vendor/bin/... commands.

A small example

Once the command is available on the shell, a typical beginner workflow looks like this:

gt create blog --namespace Blog
cd blog
gt add page about
gt run

That sequence creates a new WebEngine application, adds a page pair at page/about.html and page/about.php, then starts the local development processes needed to work on the project.

If gt is not on your PATH, the same commands can usually be run with vendor/bin/gt.


To get from zero to a running project, continue with the Quick start guide.

Clone this wiki locally