Command Line Interface

    Open a terminal and navigate to the directory of an existing Pagekit installation. The script (no file extension) in that directory is a PHP script that can be run from the command line.

    Note You might need to make this script executable using chmod +x pagekit. Alternatively you can explicetly call your PHP interpreter php pagekit.

    When simple invoking the CLI tool without any arguments, it will output the Pagekit version number, some basic usage information and list the available commands that you can use.

    1. $ ./pagekit
    2. Pagekit version 1.0.3
    4. Usage:
    5.   command [options] [arguments]
    7. Options:
    8.   -h, --help            Display this help message
    9.   -q, --quiet           Do not output any message
    10.   -V, --version         Display this application version
    11.       --ansi            Force ANSI output
    12.       --no-ansi         Disable ANSI output
    13.   -n, --no-interaction  Do not ask any interactive question
    14.   -v|vv|vvv, --verbose  Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
    16. Available commands:
    17.   archive              Archives an extension or theme
    18.   build                Builds a .zip release file
    19.   clearcache           Clears the system cache
    20.   help                 Displays help for a command
    22.   list                 Lists commands
    23.   migrate              Migrates Pagekit
    24.   self-update          Checks for newer Pagekit versions and installs the latest
    25.   setup                Setup a Pagekit installation
    26.   start                Starts the built-in web server
    27.   uninstall            Uninstalls a Pagekit package
    28.   update               Updates dependencies of Pagekit packages
    29.   extension:translate  Generates extension's translation .pot/.po/.php files
    30.  translation
    31.   translation:fetch    Fetches current translation files from languages repository

    To run a command, you can add arguments when invoking the CLI tool. For example, installing the Hello extension from the marketplace will look as follows.

    1. ./pagekit install pagekit/hello

    Available Commands

    The available commands include helpers for extension and theme developers, but also tools that make maintaining the Pagekit project itself easier for the Pagekit developer team (such as the build command).

    To create an installable *.zip archive from any theme or extension, run this command and provide the path to the package you want to build. The following command will create a file called pagekit-hello.zip in the top folder of the Pagekit installation.

    Example:

    1. ./pagekit archive pagekit/hello

    Usage, arguments and options:

    1. Usage:
    2.   archive [options] [--] <name>
    3.  
    4. Arguments:
    5.   name                  Package name
    6.  
    7. Options:
    8.       --dir[=DIR]       Write the archive to this directory

    Build Pagekit release archive

    This command is used by the Pagekit maintainers to build a Pagekit release package. It will create a *.zip archive in the root folder of the Pagekit installation. This release package can then be used both as a package as you can download it from the official Pagekit website, or as an custom installation that you could deliver, e.g. to your clients.

    Example:

    1. ./pagekit build

    Usage (no arguments, no options):

    1. Usage:
    2.   build

    Clear the cache

    To empty the cache you can use the clearcache command. This command removes all *.cache files from the cache directory, which is located at tmp/cache in a usual Pagekit installation.

    Example:

    1. ./pagekit clearcache
    1. Usage:
    2.   clearcache

    Display usage information for any CLI command

    To learn what a CLI command actually does and how it is used, you can use the help command.

    Example:

    Usage and arguments:

    1. Usage:
    2.   help [options] [--] [<command_name>]
    5.   command               The command to execute
    6.   command_name          The command name [default: "help"]
    8. Options:
    9.       --format=FORMAT   The output format (txt, xml, json, or md) [default: "txt"]

    Example:

    1. ./pagekit install pagekit/hello

    Usage, arguments and options:

    1. Usage:
    2.   install [options] [--] <packages> (<packages>)...
    3.  
    4. Arguments:
    5.   packages              [Package name]:[Version constraint]
    6.  
    7. Options:
    8.       --prefer-source   Forces installation from package sources when possible, including VCS information.

    List available commands

    You can kist all available CLI commands with the list command. This creates the same output as running the CLI script without any parameters.

    Example:

    1. ./pagekit list

    Usage, arguments and options:

    1. Usage:
    2.   list [options] [--] [<namespace>]
    3.  
    4. Arguments:
    5.   namespace            The namespace name
    6. Options:
    7.       --raw            To output raw command list
    8.       --format=FORMAT  The output format (txt, xml, json, or md) [default: "txt"]

    Run Pagekit migrations

    After a new Pagekit version has been installed, the system sometimes needs to apply changes to its database structure. These changes are grouped in so called migrations. To run any migrations that might need to be run, you can use the migrate command. In general though, you do not need to do this explicitely. When you login to the admin area, Pagekit will also check if any migrations are available and will run them if needed.

    Example:

    1. ./pagekit migrate

    Usage (no arguments or options):

    1. Usage:
    2.   migrate

    Upgrade Pagekit installation

    Upgrade your Pagekit installation from the terminal. Optionally, you can provide a link to the new Pagekit package that should be used for running the upgrade. In that case, you also need to provide a valid SHA hash that is used to verify the downloaded file. If you do not provide URL and hash, the command will use the most recent Pagekit package from pagekit.com.

    Example:

    1. ./pagekit self-update

    You can run a terminal command from a freshly downloaded Pagekit installation package to run the installation without opening the browser. This could be used for automated installs, either for yourself or client projects.

    Example to install Pagekit using SQLite and default admin user:

    1. ./pagekit setup --password=<SOMETHING-SECURE>

    Usage and options:

    1. Usage:
    2.   setup [options]
    3.  
    4. Options:
    5.   -u, --username=USERNAME      Admin username [default: "admin"]
    6.   -p, --password=PASSWORD      Admin account password
    7.   -t, --title[=TITLE]          Site title [default: "Pagekit"]
    8.   -m, --mail[=MAIL]            Admin account email [default: "admin@example.com"]
    9.   -d, --db-driver=DB-DRIVER    DB driver ('sqlite' or 'mysql') [default: "sqlite"]
    10.       --db-prefix[=DB-PREFIX]  DB prefix [default: "pk_"]
    11.   -H, --db-host[=DB-HOST]      MySQL host
    12.   -N, --db-name[=DB-NAME]      MySQL database name
    13.   -U, --db-user[=DB-USER]      MySQL user
    14.   -P, --db-pass[=DB-PASS]      MySQL password
    15.   -l, --locale[=LOCALE]        Locale

    Start the built-in webserver

    You actually do not need a full Apache server setup. You can instead run the start command for a self-contained server instance running on your local machine. The command will keep running until you hit CTRL + C to quit the server instance.

    1. ./pagekit start --server=127.0.0.1:8080

    Usage and options:

    1. Usage:
    2.   start [options]
    4. Options:
    5.   -s, --server[=SERVER]  Server name and port [default: "127.0.0.1:8080"]

    Uninstall a Pagekit package

    Removes a theme or extension from your Pagekit installation.

    Example:

    1. ./pagekit uninstall pagekit/hello

    Usage and arguments:

    1. Usage:
    2.   uninstall <packages> (<packages>)...
    4. Arguments:
    5.   packages              [Package name]

    Parse translation strings from package

    When creating a theme or extension, you can and should use Pagekit's internationalization system to make sure the user interface can be displayed in multiple languages. Basically, this works by wrapping strings in special function calls (like __('Translate me!') in PHP templates or {{ 'Translate me!' |trans }} in Vue templates. The extension:translate commands will find all occurences of such function calls in a given theme or extension, and collect all translatable strings for you and write them to the languages/ subdirectory of the specified package. These files can then be used to create translations for your package, for example using a service like Transifex.

    Example:

    1. ./pagekit extension:translate pagekit/blog

    Usage and arguments:

    1. Usage:
    2.   extension:translate [<extension>]
    3.  
    4. Arguments:
    5.   extension             Extension name

    Deprecated Warning This command will be replaced.

    This command is used by the Pagekit core maintainers to fetch translations from the Pagekit translation repository. The translation workflow and file structure is currently under discussion and this command will probably replaced in a future version of Pagekit.

    Usage:

    1. Usage:
    2.   translation:fetch