https://github.com/workofstan/seablast-dist
Distribution of Seablast for PHP - a seed application
https://github.com/workofstan/seablast-dist
Last synced: 4 months ago
JSON representation
Distribution of Seablast for PHP - a seed application
- Host: GitHub
- URL: https://github.com/workofstan/seablast-dist
- Owner: WorkOfStan
- License: mit
- Created: 2023-07-04T03:01:19.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2025-03-01T20:44:24.000Z (over 1 year ago)
- Last Synced: 2025-03-01T21:27:15.619Z (over 1 year ago)
- Language: PHP
- Size: 19.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# seablast-dist
Distribution of a seed application for `Seablast for PHP`
## Deployment
Create database with `Collation=utf8_general_ci` or rather `utf8mb3_general_ci` (create also separate testing database so that phinxlog migration_name doesn't overlap)
Before starting to develop on this boilerplate, rename the namespace according to your app.
Run [./blast.sh](./blast.sh) or [./vendor/seablast/seablast/blast.sh](https://github.com/WorkOfStan/seablast/blob/v0.2.10.1/blast.sh) to
- create `conf/phinx.local.php` based on [conf/phinx.dist.php](conf/phinx.dist.php) including the name of the database (and testing database) created above
- create `conf/app.conf.local.php` based on [conf/app.conf.dist.php](conf/app.conf.dist.php) including the phinx environment to be used and change any settings you like. (OPTIONAL)
Edit these two configuration files; then re-run blast.sh
Note: the current configuration is in the `conf/phinx.local.php` so that it is automatically NOT commited to Git
If PHPStan reports `Constant APP_DIR not found.` error, just uncomment lines in [conf/phpstan.webmozart-assert.neon](conf/phpstan.webmozart-assert.neon).
```sh
# For all the deployment and development options, run
./vendor/seablast/seablast/blast.sh -?
```
### Folders, where web can write
- cache and log (and also e.g. app specific uploads)
- rights: 2775
- owner: server user, e.g. composerit
- group: web user, e.g. www-data
- run [permissions.sh](permissions.sh) to set up these permissions
- upload_max_filesize in php.ini set to 8M
### Security
- enforcing HTTP to HTTPS MUST happen on the server-side, e.g. like this in `/etc/apache2/sites-enabled/www.plysonika.cz.conf`
```htaccess
RewriteEngine On
RewriteCond %{REQUEST_URI} !^/server-status.*
RewriteRule ^/?(.*) https://%{SERVER_NAME}/$1 [R,L]
```
## Examples
- try /redir to see how it is redirected to /kontakt
- try /use-mirror to see how API call works
- try /arithmetic to see a simple MVC + Latte + DB demo
## App directory description
| Directory | Description |
| --------- | ------------------------------------------------------------------------------------------------- |
| .github/ | Automations |
| assets/ | Frontend assets. When dealing with numerous assets, categorize them into specific subdirectories. |
| cache/ | Latte cache (deployed by [blast.sh](blast.sh)) |
| conf/ | All configuration files: Seablast app, PHPStan, phinx |
| log/ | All kind of logs |
| src/ | Classes with respecitve subfolders src/Data, src/Exceptions, src/Models... |
| views/ | Latte templates |