Edit on GitHub

Utility Commands

The following commands are utility commands available on Winter installations.

Run unit tests

php artisan winter:test [--core] [--plugin=] [--configuration=]

The winter:test command runs the unit tests for the entire project, a specific plugin, or the Winter core.

To run the entire project's unit tests:

php artisan winter:test

Or, to run only the core unit tests, use the -o or --core option:

php artisan winter:test -o

To run a specific plugin's tests, use the -p or --plugin= option:

php artisan winter:test -p Acme.Demo

To run a custom test suite, use the -c or --configuration= option:

php artisan winter:test -c ./custom-path/phpunit.xml

If using additional PHPUnit parameters / options, they must be included after the winter:test command's options:

php artisan winter:test -p Acme.Demo --filter=FilteredTest --stop-on-failure

Utility runner

winter:util - a generic command to perform general utility tasks, such as cleaning up files or combining files. The arguments passed to this command will determine the task used.

Compile Winter assets

Outputs combined system files for JavaScript (js), StyleSheets (less), client side language (lang), or everything (assets).

php artisan winter:util compile assets
php artisan winter:util compile lang
php artisan winter:util compile js
php artisan winter:util compile less

To combine without minification, pass the --debug option.

php artisan winter:util compile js --debug

Pull all repos

This will execute the command git pull on all theme and plugin directories.

php artisan winter:util git pull

Purge thumbnails

Deletes all generated thumbnails in the uploads directory.

php artisan winter:util purge thumbs

Purge uploads

Deletes files in the uploads directory that do not exist in the "system_files" table.

php artisan winter:util purge uploads

Purge orphaned uploads

Deletes records in "system_files" table that do not belong to any other model.

php artisan winter:util purge orphans

To also delete records that have no associated file in the local storage, pass the --missing-files option.

php artisan winter:util purge orphans --missing-files

Keep informed

Sign up to our newsletter to receive updates on Winter CMS releases, new features in the works, and much more.
We'll never spam or give this address away.

Latest blog post

Winter: 16 Months Later

Published July 14, 2022
With the first year of Winter behind us, let's take a look at what we were able to achieve in 2021.

View this post Read all posts

Latest Winter CMS release

v1.2.1

Released October 20, 2022
14 UX/UI Improvements, 25 API Changes, 33 Bug Fixes, 4 Security Improvements, 5 Translation Improvements, 1 Performance Improvement, 2 Community Improvements, 2 Dependencies, 0 New Contributors * @cstorus made their first contribution in https://github.com/wintercms/winter/pull/616 * @simonmannsfeld made their first contribution in https://github.com/wintercms/winter/pull/623 * @quangtrongonline made their first contribution in https://github.com/wintercms/winter/pull/636 * @nathanlesage made their first contribution in https://github.com/wintercms/winter/pull/665 * @vllvll made their first contribution in https://github.com/wintercms/winter/pull/669 * @robertalexa made their first contribution in https://github.com/wintercms/winter/pull/668 * @iamyigitkoc made their first contribution in https://github.com/wintercms/winter/pull/624 * @hecc127 made their first contribution in https://github.com/wintercms/winter/pull/682 * @prsuhas made their first contribution in https://github.com/wintercms/winter/pull/723

View details View all releases