The goal of this extension to improve the command line usage with TYPO3 CMS inspired by the command line interface of TYPO3 Flow. It aims to provide a consistent and easy to use interface for users and an easy API for developers. Every command that is shipped provides helpful information about usage and is easy to understand and use.
TYPO3 CMS already has a command line interface but executing commands can look like this:
# Run reference index check
./typo3/cli_dispatch.phpsh lowlevel_refindex -c
# Update translated labels
./typo3/cli_dispatch.phpsh extbase language:update
# Lock editing in the backend
./cli_dispatch.phpsh lowlevel_admin setBElock
This extension comes with a command line tool called typo3cms
and you can execute the commands from above like this:
# Run reference index check
./typo3cms cleanup:updatereferenceindex --dry-run
# Update translated labels
./typo3cms language:update
# Lock editing in the backend
./typo3cms backend:lock
Additionally it provides some commands, that wouldn't be possible at all with the current core command line interface:
# Force flush all caches in a reliable and robust way
./typo3cms cache:flush --force
# Interactively set up a new TYPO3 instance from command line (instead of using the install tool)
./typo3cms install:setup
# Non interactive automatic setup of a new TYPO3 instance
./typo3cms install:setup --non-interactive \
--database-user-name="root" \
--database-host-name="localhost" \
--database-port="3306" \
--database-name="travis_test" \
--admin-user-name="admin" \
--admin-password="password" \
--site-name="Travis Install"
# Populate essential core caches
./typo3cms cache:warmup
# Perform safe database schema updates
./typo3cms database:updateschema "*.add,*.change"
A help system is integrated, so that you can easily list all available commands or get help for individual commands:
# List all commands with a short description
./typo3cms help
# Show detailed help for an individual command
./typo3cms help cache:flush
- Question
How does
typo3_console
compare tocoreapi
?- Answer
There is a blog post that explains the differences and points out the benefits of
typo3_console
- Question
Why isn't this functionality part of the TYPO3 core? Wouldn't it make sense?
- Answer
Absolutely! Only, nobody did this until now. I also think that it is good to develop and stabilize this as third party product. It is possible to get feedback, iterate and improve much faster than with a TYPO3 CMS core release. Once the extension has matured, I'm fine to integrate it as core functionality.
- Question
When will this be part of the TYPO3 CMS core?
- Answer
It might find its way into TYPO3 CMS 7, who knows. Until then you can already use it as extension in TYPO3 6.2 and 7.x