https://github.com/nullstone-io/laravel-quickstart
PHP Laravel Quickstart for Nullstone
https://github.com/nullstone-io/laravel-quickstart
Last synced: 9 months ago
JSON representation
PHP Laravel Quickstart for Nullstone
- Host: GitHub
- URL: https://github.com/nullstone-io/laravel-quickstart
- Owner: nullstone-io
- License: mit
- Created: 2022-04-28T16:55:22.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2023-08-18T14:53:44.000Z (almost 3 years ago)
- Last Synced: 2025-05-06T08:58:39.861Z (about 1 year ago)
- Language: PHP
- Size: 122 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# laravel-quickstart
This is a PHP Laravel Quickstart for [Nullstone](https://nullstone.io).
This is based on the Laravel [install guide](https://laravel.com/docs/8.x/installation).
This quickstart uses the production-ready docker image [nullstone/laravel](https://hub.docker.com/r/nullstone/laravel) that works locally with hot-reload.
The base docker image can be found at [github.com/nullstone-io/docker-laravel](https://github.com/nullstone-io/docker-laravel).
This quickstart is set up with:
- PHP 8.1
- Laravel
- Static Assets
- Configured to hot-reload assets for local development
- Served through NGINX for docker builds
- Postgresql Database
- Error logs
- Emitted to stdout for docker builds
- Pretty errors for local development
- Hot reload for local development
## How to launch via Nullstone
1. Create postgresql datastore.
2. Create a public web app. (Remember `app-name` for later)
3. Add the postgresql datastore (from step 1) to the app.
4. Add a subdomain. (this will add a Load Balancer capability)
5. Add the `APP_KEY for Laravel` capability to the app. (This enables encryption of cookies)
6. Add the `Nginx Sidecar for Fargate Service` capability to the app.
7. Provision
```shell
nullstone up --wait --block= --env=
```
8. Build, push, and deploy
```shell
docker build -t laravel-app .
nullstone launch --source=laravel-app --app= --env=
```
## Running locally
You can run this project locally inside Docker or using a dev server.
The docker setup is configured to hot reload; you don't have to rebuild/restart the container when you change code.
### Docker
```shell
docker compose up
```
Visit [http://localhost:9000](http://localhost:9000).
### Hot reload
The `app` in `docker-compose.yml` is configured to automatically reload changes to files.
You do not need to rebuild/restart the app when making changes to Laravel files.
However, when updating dependencies, you will need to restart your docker container.
The dependencies will be installed on boot of the docker container.
## Details about quickstart
1. `composer create-project laravel/laravel .`