Download the PHP package itmundi/schematic without Composer
On this page you can find all versions of the php package itmundi/schematic. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package schematic
Schematic (for Craft 3) 
Schematic allows you to synchronize your Craft setup over multiple environments. It does this by exporting information about assets, database (fields, sections, users), locales and plugins to a YAML file that can be imported in other environments.
:exclamation: Craft 3.1 notice
Craft 3.1 brings project config that will deliver most if not all schematic functionality natively. We will continue to support schematic going forward, but it seems likely to become obsolete.
Currently Schematic will not run on Craft 3.1 or higher!
Installation
This tool can be installed using Composer. Run the following command from the root of your project:
This will add nerds-and-company/schematic as a requirement to your project's composer.json file and install the source-code into the vendor/nerds-and-company/schematic directory.
Schematic is now available as an installable plugin in Craft. You can install it in the cp or use ./craft install/plugin schematic
Usage
Basic usage
The most common usage pattern of this tool, to synchronize from a development to a production environment, would be:
- Create a Craft project locally
- Set up all of the desired plugins, sections, templates, etc.
- Run a Schematic export locally
- Optionally, if a revision control system is used, commit the schema file to the local repository
- Deploy the Craft application to a production environment
- Run a Schematic import remotely
Or, to synchronize from a production to a development environment:
- Run a Schematic export remotely
- Pull the schema file locally
- Optionally, if a revision control system is used, commit the schema file to the local repository
- Run a Schematic import locally
Exporting
An export can be created by running:
To skip exporting a specific of data type, exclusions can be specified in the following form:
Multiple exclusions can also be specified:
The same goes for only exporting a subset of data types:
See [Supported DataTypes](#Supported DataTypes)
An export will generate a schema file at config/schema.yml. The file path can be changed using the --file flag, for instance craft schematic/export --file=path/to/my-schema.yml
Importing
To run an import with schematic, a schema file needs to be present. An import can be created by running:
By default schematic will look at config/schema.yml. To change the path where schematic will look for the schema file, use the --file flag.
Optionally the --force flag can be used to make the import delete any items which are not mentioned in the import file.
WARNING!! This will also delete any related content.
To skip importing a specific of data type, exclusions can be specified in the following form:
Multiple exclusions can also be specified:
See [Supported DataTypes](#Supported DataTypes)
Supported DataTypes
Here is a list of all of the data types and their corresponding exclude parameter values:
| Data Type | Exclude/Include Parameter |
|---|---|
| plugins | plugins |
| Sites | sites |
| Asset Transforms | assetTransforms |
| Category Groups | categoryGroups |
| Element Indexes | elementIndexSettings |
| Email Settings | emailSettings |
| Fields | fields |
| General Settings | generalSettings |
| Global Sets | globalSets |
| Plugins | plugins |
| Sections | sections |
| Tag Groups | tagGroups |
| User Settings | userSettings |
| User Groups | userGroups |
| Volumes | volumes |
Overrides and environment variables
Specific keys can be overriden by adding a key in config/override.yml and setting the corresponding environment variable. The key name in the override.yml needs to be the same as the key you want to override from schema.yml, including any parent key names.
The override file is also applied back when exporting, so your variables are not overriden by actual values. Schematic also supports passing an override file using the --override-file flag, for instance: ./craft schematic/import --override-file=path/to/your/config/override.yml.
Example
If the following override.yml is defined:
Then the environment variable KEY_VALUE needs to be set. The value of this environment variable will override the key key_name. If the environment variable is not set Schematic will throw an error.
Environment variables can also directly be used in the schema.yml file. Beware that if you do that, they will be overriden on export by their environment variable's values.
Events
Custom converters can be injected with the EVENT_RESOLVE_CONVERTER event.
This can be especially useful for importing and exporting custom field types.
The converters need to implement the NerdsAndCompany\Schematic\Interfaces\ConverterInterface.
Custom source mappings can be injected with the EVENT_MAP_SOURCE event.
This can be especially useful for importing and exporting custom sources.
Caveats
Schematic uses handles to identify content. When a handle is changed in the schema file and import is run with force a new content type will be created with that handle, and the old content type will be deleted!
It is recommended to change content type handles with craft content migrations and to run these migration before running a schematic import.
License
This project has been licensed under the MIT License (MIT). Please see License File for more information.
Changelog
CHANGELOG.md
Credits
Inspired and based on the awesome ArtVandelay Plugin and built by these awesome individuals
