sumocoders / application-skeleton
Installs: 604
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 7
Forks: 6
Open Issues: 0
Type:project
Requires
- php: ^8.3
- ext-ctype: *
- ext-iconv: *
- ext-sodium: *
- symfony/flex: ^2
- dev-master
- v12.0.1
- v12.0.0
- v11.2.0
- v11.1.2
- v11.1.1
- v11.1.0
- v11.0.0
- v10.0.2
- v10.0.1
- v10.0.0
- v9.3.0
- v9.2.0
- v9.1.0
- v9.0.3
- v9.0.2
- v9.0.1
- v9.0.0
- v8.0.0
- v7.0.6
- v7.0.5
- v7.0.4
- v7.0.3
- v7.0.2
- v7.0.1
- v7.0
- v6.6
- v6.5.0
- v6.4.2
- v6.4.1
- v6.4.0
- v6.3.1
- v6.3.0
- v6.2.0
- v6.1.5
- v6.1.4
- v6.1.3
- v6.1.2
- v6.1.1
- v6.1.0
- v6.0.4
- v6.0.3
- v6.0.2
- v6.0.1
- v6.0.0
- v5.1.1
- v5.1.0
- v5.0.1
- v5.0.0
- v4.1.3
- v4.1.2
- v4.1.1
- v4.1.0
- v4.0.0
- v3.3.0
- v3.2.0
- v3.1.0
- v3.0.1
- v3.0.0
- v2.0.0
- v1.3.0
- v1.2.0
- v1.1.0
- v1.0.0
This package is auto-updated.
Last update: 2024-10-30 07:57:46 UTC
README
Use the following commands to create a new project:
composer create-project sumocoders/application-skeleton my_project
git init
git add .
git commit -n -m "Initial commit"
Start you project by running:
symfony serve
npm run watch
Configuration
Deployment
Open deploy.php
and check the configuration, replace the example values
(prefixed with $
) with correct values.
Try to deploy to staging by running:
symfony php vendor/bin/deployer.phar deploy staging
Log in through ssh
on the dev-server and alter the .env.local
-file to use the
correct credentials.
Continuous deployment to staging
Each time something is merged into the staging branch it can be deployed automatically. To do so, follow the steps below:
- Open the project in Gitlab.
- Open Settings → Repository → Deploy Keys.
- Click the tab "Privately accessible deploy keys" and enable the key called "Sumo deploy user".
- Open Settings → CI / CD → Variables.
- Add a variable called
SSH_PRIVATE_KEY
, the value can be found in 1Password under "Sumo Deploy User private key". You can check the "Protect variable" flag. - Add a variable called
SSH_KNOWN_HOSTS
, the value should be the output ofssh-keyscan -H dev02.sumocoders.eu
. - Open
.gitlab-ci.yaml
, scroll toDeploy - to staging
. - Alter the url under
environment → url
.
Usage
Using Encore
Building assets:
# compile assets once
npm run dev
# or, recomile assets automatically when files change
npm run watch
# on deploy, create a production build
npm run build
For more information about Encore, see the official documentation.
Tests
We use panther to add functional tests to our project.
By default, a page response 200 should be tested on al pages. To do this you can add your urls to the providePublicUrls
and/or provideLoggedInUrls
.
Working on the Skeleton
Testing create-project
locally
There is a test-script scripts/test.sh
which you can use:
COMPOSER_MEMORY_LIMIT=-1 ./scripts/test.sh BRANCH-TO_TEST TARGETDIR
This will create a new project that uses the commited code in the selected branch. The new project will be located in the TARGETDIR
Kudos to beporter.