Download the PHP package sbuerk/typo3-ensure-admin without Composer
On this page you can find all versions of the php package sbuerk/typo3-ensure-admin. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download sbuerk/typo3-ensure-admin
More information about sbuerk/typo3-ensure-admin
Files in sbuerk/typo3-ensure-admin
Package typo3-ensure-admin
Short Description Provides a TYPO3 cli command to create or update admin user
License GPL-2.0-or-later
Informations about the package typo3-ensure-admin
TYPO3 Ensure Admin
State
Workflow | main (2.x) | 1 (1.x) |
---|---|---|
tests core 10 | - | |
tests core 11 | - | |
tests core 12 | - |
Mission
The mission of this extension is to provide a tool to create and update users for staging and development purpose. Thus, it should be only taken as development dependencies for projects.
Additionally, it provides a simple password encoding command, which may be used to encode a password and use it to set the TYPO3 installtool password, for example.
:information_source: This extension only handles backend user compatible passwords. This means, Frontend Users passwords are not handled.
Version compatibility
version | TYPO3 | PHP |
---|---|---|
2.x | v11 + v12 | 7.4, 8.0, 8.1, 8.2 |
1.x | v10 | 7.2, 7.3, 7.4 |
Alternatives
TYPO3 Console includes some commands, which (partly) can do which this extension tries to archieve. If you are already using it, maybe existing features suits you. Then stay with that extension.
:information_source: We are not aware of further extensions providing similar abilities. Let us know if there are some, and we will add them here as alternative.
Installation
Composer
You probably want to install this as --dev
dependency.
Usage
ensure admin user
Synopsis:
This command can be used to create or update admin user. If a user exists, the
--force
flag must be provided to update the admin user.
Additionally, this command supports JSON Response
results instead of normal
text outputs, which may be used for integrating in other tools or workflows. Use
the --json
flag to retrieve JSON Results
.
Some options are required and mandatory, others are optional. Options can be
provided as command line options or as Environment Variables, except --json
and --enforce
flags.
:information_source: If for an option both variants are provided, the option variants preceeds the Environment Variable variant.
option | required | env variable | description |
---|---|---|---|
--name= | yes | TYPO3_ENSUREADMIN_USERNAME |
Admin username |
--password= | yes | TYPO3_ENSUREADMIN_PASSWORD |
Sets the admin password |
--email= | no | TYPO3_ENSUREADMIN_EMAIL |
Sets the admin email address. |
--firstname= | no | TYPO3_ENSUREADMIN_FIRSTNAME |
Will be used in combination with lastname to set the admin realName |
--lastname= | no | TYPO3_ENSUREADMIN_LASTNAME |
Will be used in combination with firstname to set the admin realName |
--json | no | - | Return messages as json objects/strings |
--force | no* | - | Required if you want to update an existing admin user. Optional/not used if new admin user is created. |
JSON Response structure:
Normal mode
and JSON result mode
both provides proper exit codes, which may
be used as a first indicator without really reading the output.
result-state | exit code |
---|---|
success | 0 |
failure | 1 |
password encode
Synopsis:
argument/option | description |
---|---|
plain-password | You must specify the plan password you want to encode. This is required. |
--json | Optional Add this flag if you want json responses instead of human readable output. |
JSON Response structure:
Normal mode
and JSON result mode
both provides proper exit codes, which may
be used as a first indicator without really reading the output.
result-state | exit code |
---|---|
success | 0 |
failure | 1 |
TYPO3 Extension Repository
For non-composer projects, the extension is available in TER as extension key
cli_ensure_admin
and can be installed using the extension manager.
Tagging and releasing
packagist.org is enabled via the casual github hook. TER releases are created by the "publish.yml" github workflow when tagging versions using tailor. The commit message of the tagged commit is used as TER upload comment.
Feedback / Bug reports / Contribution
Bug reports, feature requests and pull requests are welcome in the GitHub repository: https://github.com/sbuerk/typo3-ensure-admin