zendframework / zftool
Utility module for Zend Framework 2 applications.
Installs: 1 412 700
Dependents: 42
Suggesters: 0
Security: 0
Stars: 194
Watchers: 50
Forks: 115
Open Issues: 34
Requires
- php: >=5.3.3
- zendframework/zend-code: >=2.2.2
- zendframework/zend-config: >=2.2.2
- zendframework/zend-console: >=2.2.2
- zendframework/zend-file: >=2.2.2
- zendframework/zend-form: >=2.2.2
- zendframework/zend-http: >=2.2.2
- zendframework/zend-loader: >=2.2.2
- zendframework/zend-modulemanager: >=2.2.2
- zendframework/zend-mvc: >=2.2.2
- zendframework/zend-serializer: >=2.2.2
- zendframework/zend-servicemanager: >=2.2.2
- zendframework/zend-stdlib: >=2.2.2
- zendframework/zend-text: >=2.2.2
- zendframework/zend-version: >=2.2.2
- zendframework/zend-view: >=2.2.2
- zendframework/zenddiagnostics: >=1.0.0
This package is auto-updated.
Last update: 2019-12-06 17:22:27 UTC
README
Repository abandoned 2019-12-05
This repository is no longer maintained. Tooling was not updated to work with ZF3, and with the transition to Laminas, we will be deciding what, if any, new tooling we want to provide for the MVC framework.
ZFTool is an utility module for maintaining modular Zend Framework 2 applications. It runs from the command line and can be installed as ZF2 module or as PHAR (see below).
Features
- Class-map generator
- Listing of loaded modules
- Create a new project (install the ZF2 skeleton application)
- Create a new module
- Create a new controller
- Create a new action in a controller
- Application diagnostics
Requirements
- Zend Framework 2.0.0 or later.
- PHP 5.3.3 or later.
- Console access to the application being maintained (shell, command prompt)
Installation using Composer
- Open console (command prompt)
- Go to your application's directory.
- Run
composer require zendframework/zftool:dev-master
- Execute the
vendor/bin/zf.php
as reported below
Using the PHAR file (zftool.phar)
- Download the zftool.phar from packages.zendframework.com
- Execute the
zftool.phar
with one of the options reported below (zftool.phar
replace thezf.php
)
You can also generate the zftool.phar using the bin/create-phar
command as reported below
Usage
Basic information
zf.php modules [list] show loaded modules
zf.php version | --version display current Zend Framework version
Diagnostics
zf.php diag [options] [module name]
[module name] (Optional) name of module to test
-v --verbose Display detailed information.
-b --break Stop testing on first failure.
-q --quiet Do not display any output unless an error occurs.
--debug Display raw debug info from tests.
Project creation
zf.php create project <path>
<path> The path of the project to be created
Module creation
zf.php create module <name> [<path>]
<name> The name of the module to be created
<path> The path to the root folder of the ZF2 application (optional)
Controller creation:
zf.php create controller <name> <module> [<path>]
<name> The name of the controller to be created
<module> The module in which the controller should be created
<path> The root path of a ZF2 application where to create the controller
Action creation:
zf.php create action <name> <controller> <module> [<path>]
<name> The name of the action to be created
<controller> The name of the controller in which the action should be created
<module> The module containing the controller
<path> The root path of a ZF2 application where to create the action
Application configuration
zf.php config list list all configuration option
zf.php config get <name> display a single config value, i.e. "config get db.host"
zf.php config set <name> <value> set a single config value (use only to change scalar values)
Classmap generator
zf.php classmap generate <directory> <classmap file> [--append|-a] [--overwrite|-w]
<directory> The directory to scan for PHP classes (use "." to use current directory)
<classmap file> File name for generated class map file or - for standard output. If not supplied, defaults to
autoload_classmap.php inside <directory>.
--append | -a Append to classmap file if it exists
--overwrite | -w Whether or not to overwrite existing classmap file
ZF library installation
zf.php install zf <path> [<version>]
<path> The directory where to install the ZF2 library
<version> The version to install, if not specified uses the last available
Compile the PHAR file
You can create a .phar file containing the ZFTool project. In order to compile ZFTool in a .phar file you need to execute the following command:
bin/create-phar
This command will create a zftool.phar file in the bin folder. You can use and ship only this file to execute all the ZFTool functionalities. After the zftool.phar creation, we suggest to add the folder bin of ZFTool in your PATH environment. In this way you can execute the zftool.phar script wherever you are, for instance executing the command:
mv zftool.phar /usr/local/bin/zftool.phar
Note: If the above fails due to permissions, run the mv line again with sudo.
Todo
- Module maintenance (installation, configuration, removal etc.) [installation DONE]
- Inspection of application configuration. [DONE]
- Deploying zf2 skeleton applications. [DONE]
- Reading and writing app configuration. [DONE]