|
2 | 2 |
|
3 | 3 | [](https://coveralls.io/github/RonasIT/laravel-empty-project?branch=development)
|
4 | 4 |
|
5 |
| -### Resources |
6 |
| -Below are links to tools and services used in this project: |
7 |
| -- Issue Tracker: Here, you can report any issues or bugs related to the project. [Issue Tracker](https://github.com/Goodmain/project-management-backpack-laravel/issues) |
8 |
| -- [API Documentation](http://localhost) |
9 |
| - |
10 |
| -### Contacts |
11 |
| -Should you need assistance or have questions, feel free to connect with the following individuals: |
12 |
| -- Code Owner: For specific questions about the codebase or technical aspects, reach out to our team lead. [Connect with Code Owner ]([email protected]) |
13 |
| - |
14 |
| -Please be mindful of each individual's preferred contact method and office hours. |
| 5 | +This repository can be used to scaffold a Laravel project. |
15 | 6 |
|
16 | 7 | ## Prerequisites
|
| 8 | + |
17 | 9 | To work with this repository, you will need to have the following
|
18 | 10 | installed:
|
| 11 | + |
19 | 12 | - [Docker](https://www.docker.com)
|
20 | 13 |
|
21 | 14 | ## Getting Started
|
| 15 | + |
22 | 16 | To get started with this repository, follow these steps:
|
| 17 | + |
23 | 18 | Clone this repository to your local machine.
|
| 19 | + |
| 20 | +```sh |
| 21 | +git clone [email protected]:RonasIT/laravel-empty-project.git |
| 22 | +``` |
| 23 | + |
| 24 | +Remove the existing GitHub [remote](https://git-scm.com/docs/git-remote). |
| 25 | + |
24 | 26 | ```sh
|
25 |
| -git clone [email protected]:Goodmain/project-management-backpack-laravel.git |
| 27 | +git remote remove origin |
26 | 28 | ```
|
| 29 | + |
| 30 | +Add your project remote. |
| 31 | + |
| 32 | +```sh |
| 33 | +git remote add origin <project_git_url> |
| 34 | +``` |
| 35 | + |
27 | 36 | Build and start containers. It may takes some time.
|
| 37 | + |
28 | 38 | ```sh
|
29 | 39 | docker compose up -d
|
30 | 40 | ```
|
31 | 41 |
|
32 |
| -## Environments |
| 42 | +Check docker containers health status. |
| 43 | + |
| 44 | +```sh |
| 45 | +docker ps |
| 46 | +``` |
| 47 | + |
| 48 | +You should see something like this. |
| 49 | + |
| 50 | +``` |
| 51 | +CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES |
| 52 | +5ae2e24d63bb ronasit/php-nginx-dev:8.1 "/entrypoint bash -c…" About a minute ago Up About a minute 0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp, 9000/tcp laravel-empty-project-nginx-1 |
| 53 | +ef37a992c53c webdevops/php:8.1-alpine "/entrypoint supervi…" About a minute ago Up About a minute 9000/tcp laravel-empty-project-php-1 |
| 54 | +e02e9f746731 ronasit/postgres:12.5 "docker-entrypoint.s…" About a minute ago Up About a minute 0.0.0.0:5433->5432/tcp laravel-empty-project-pgsql_test-1 |
| 55 | +4e1fda859342 ronasit/postgres:12.5 "docker-entrypoint.s…" About a minute ago Up About a minute 0.0.0.0:5432->5432/tcp laravel-empty-project-pgsql-1 |
| 56 | +728c83486f92 redis:6.2.3 "docker-entrypoint.s…" About a minute ago Up About a minute 0.0.0.0:6379->6379/tcp laravel-empty-project-redis-1 |
| 57 | +``` |
| 58 | + |
| 59 | +Connect to the `nginx` container. |
| 60 | + |
| 61 | +```sh |
| 62 | +docker exec -i -t laravel-empty-project-nginx-1 /bin/bash |
| 63 | +``` |
| 64 | + |
| 65 | +Init your new project. |
| 66 | + |
| 67 | +```sh |
| 68 | +php artisan init <project_name> |
| 69 | +``` |
| 70 | + |
| 71 | +Set required configs: `contact.email` in the `configs/auto-doc.php`. |
| 72 | + |
| 73 | +Run tests to generate documentation |
| 74 | + |
| 75 | +```sh |
| 76 | +php vendor/bin/phpunit tests/ |
| 77 | +``` |
| 78 | + |
| 79 | +API documentation can be accessed by visiting `http://localhost` in your |
| 80 | +web browser. |
| 81 | + |
| 82 | +### Environments |
| 83 | + |
33 | 84 | This repository by default supports three environments: `local`, `development`,
|
34 | 85 | and `testing`. Each environment is represented by an appropriate environment file:
|
35 | 86 |
|
36 |
| -| Environment | File | URL | |
37 |
| -| --- | --- |--------------------------------------| |
38 |
| -| local | .env | [http://localhost](http://localhost) | |
39 |
| -| testing | .env.testing | - | |
40 |
| -| development | .env.development | [http://localhost](http://localhost) | |
| 87 | +- .env |
| 88 | +- .env.development |
| 89 | +- .env.testing |
| 90 | + |
| 91 | +## Contributing |
41 | 92 |
|
42 |
| -## Credentials and Access |
43 |
| -Default admin email and password: `[email protected]`/ `a318afa8` |
| 93 | +Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details. |
0 commit comments