{"id":20551575,"url":"https://github.com/do-community/landing-laravel","last_synced_at":"2025-04-14T11:30:44.502Z","repository":{"id":70566514,"uuid":"311379714","full_name":"do-community/landing-laravel","owner":"do-community","description":"A demo Laravel 8 + Docker Compose application","archived":false,"fork":false,"pushed_at":"2022-08-23T11:17:24.000Z","size":177,"stargazers_count":30,"open_issues_count":0,"forks_count":13,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-03-28T00:44:02.448Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/do-community.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-11-09T15:21:05.000Z","updated_at":"2024-10-11T17:33:32.000Z","dependencies_parsed_at":null,"dependency_job_id":"479a2cc0-3055-4204-a112-593c77264055","html_url":"https://github.com/do-community/landing-laravel","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/do-community%2Flanding-laravel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/do-community%2Flanding-laravel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/do-community%2Flanding-laravel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/do-community%2Flanding-laravel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/do-community","download_url":"https://codeload.github.com/do-community/landing-laravel/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248871660,"owners_count":21175267,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-16T02:32:16.300Z","updated_at":"2025-04-14T11:30:44.477Z","avatar_url":"https://github.com/do-community.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Landing Laravel - A Demo Laravel Application\n\nThis application was initially developed in the following tutorial series:\n[How To Build a Links Landing Application in PHP with Laravel and Docker Compose](https://www.digitalocean.com/community/tutorial_series/how-to-build-a-links-landing-page-in-php-with-laravel-and-docker-compose).\n\nA second series called [A Practical Introduction to Laravel Eloquent ORM](https://www.digitalocean.com/community/tutorial_series/a-practical-introduction-to-laravel-eloquent-orm) further develops this demo application to include new models and relationships.\n\n## Releases and Tutorials\n\nThe application uses GitHub releases to support a progressive learning strategy, with multiple versions based on each part of the series. Here’s an overview of all available releases:\n\n### Laravel Introduction Series\n- [How To Build a Links Landing Application in PHP with Laravel and Docker Compose](https://www.digitalocean.com/community/tutorial_series/how-to-build-a-links-landing-page-in-php-with-laravel-and-docker-compose) [`0.1.1`](https://github.com/do-community/landing-laravel/releases/tag/0.1.1)\n\n\n### Eloquent Series\n- [Tutorial **1**: How To Create a One-to-Many Relationship in Laravel Eloquent](https://www.digitalocean.com/community/tutorials/how-to-create-a-one-to-many-relationship-in-laravel-eloquent) [`elo-tutorial1.0`](https://github.com/do-community/landing-laravel/releases/tag/elo-tutorial1.0)\n- [Tutorial **2**: How To Insert New Database Records in Laravel Eloquent](https://www.digitalocean.com/community/tutorials/how-to-insert-new-database-records-in-laravel-eloquent) [`elo-tutorial2.0`](https://github.com/do-community/landing-laravel/releases/tag/elo-tutorial2.0)\n- [Tutorial **3**: How To Populate a Database with Sample Data using Laravel Seeders and Eloquent Models](https://www.digitalocean.com/community/tutorials/how-to-populate-a-database-with-sample-data-using-laravel-seeders-and-eloquent-models) [`elo-tutorial3.0`](https://github.com/do-community/landing-laravel/releases/tag/elo-tutorial3.0)\n- [Tutorial **4**: How To Query the Database in Laravel with Eloquent Select](https://www.digitalocean.com/community/tutorials/how-to-query-the-database-in-laravel-with-eloquent-select) [`elo-tutorial4.0`](https://github.com/do-community/landing-laravel/releases/tag/elo-tutorial4.0)\n- [Tutorial **5**: How to Refine Database Queries with Eloquent Where](https://www.digitalocean.com/community/tutorials/how-to-refine-database-queries-in-laravel-with-eloquent-where) [`elo-tutorial5.0`](https://github.com/do-community/landing-laravel/releases/tag/elo-tutorial5.0)\n- [Tutorial **6**: How To Order Query Results in Laravel Eloquent](https://www.digitalocean.com/community/tutorials/how-to-order-query-results-in-laravel-eloquent) [`elo-tutorial6.0`](https://github.com/do-community/landing-laravel/releases/tag/elo-tutorial6.0)\n- [Tutorial **7**: How To Get Total Result Count in Laravel Eloquent](https://www.digitalocean.com/community/tutorials/how-to-get-total-result-count-in-laravel-eloquent) [`elo-tutorial7.0`](https://github.com/do-community/landing-laravel/releases/tag/elo-tutorial7.0)\n- [Tutorial **8**: How To Limit and Paginate Query Results in Laravel Eloquent](https://www.digitalocean.com/community/tutorials/how-to-limit-and-paginate-query-results-in-laravel-eloquent) [`elo-tutorial8.0`](https://github.com/do-community/landing-laravel/releases/tag/elo-tutorial8.0)\n- [Tutorial **9**: How To Update Database Records in Laravel Eloquent](https://www.digitalocean.com/community/tutorials/how-to-update-database-records-in-laravel-eloquent) [`elo-tutorial9.0`](https://github.com/do-community/landing-laravel/releases/tag/elo-tutorial9.0)\n- [Tutorial **10**: How To Delete Database Records in Laravel Eloquent](https://www.digitalocean.com/community/tutorials/how-to-delete-database-records-in-laravel-eloquent) [`elo-tutorial10.0`](https://github.com/do-community/landing-laravel/releases/tag/elo-tutorial10.0)\n \n## About\nThis application creates a links landing page where you can share relevant links to an audience.\nLinks are initially imported from a `links.yml` file in the root of the application, and can be managed via Artisan commands (in the console / command-line).\n\n\u003cp align=\"center\"\u003e\n\u003ca title=\"Deploy this application to DigitalOceans App Platform in a few clicks!\" href=\"https://cloud.digitalocean.com/apps/new?repo=https://github.com/do-community/landing-laravel/tree/main\"\u003e\u003cimg src=\"https://mp-assets1.sfo2.digitaloceanspaces.com/deploy-to-do/do-btn-blue.svg\" alt=\"Deploy to DO button\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n![Landing Laravel - application screenshot](https://assets.digitalocean.com/articles/landing_laravel_series/landing_final.png)\n\n\n## Managing Links\nLinks are initially imported from a `links.yml` file at the root of the repository. The seeds are only imported when the database is empty, so to not duplicate your links.\n\nLink management is done via Artisan commands:\n\n```shell\nphp artisan link:list\nphp artisan link:create\nphp artisan link:delete [LINK_ID]\n```\n\n## Deploying via DO Deploy Button\nIf you want to try [DigitalOcean's App Platform](https://www.digitalocean.com/docs/app-platform/) with this application, you may want to use the *Deploy to DigitalOcean* button at the top of this README.\nThis will give you less customization options, but you can still manage your links via the console, on the App Platform dashboard.\n\n## Development Workflow with Docker Compose\nThe application includes a Docker Compose setup that you can use for development. \nPlease follow the [linked tutorial series](https://www.digitalocean.com/community/tutorial_series/how-to-build-a-links-landing-page-in-php-with-laravel-and-docker-compose) for more information about how to set up Docker and Docker Compose.\n\nIt's recommended that you fork this repository to your own Github account. \nThen, clone your forked repository so that you can make changes to the application.\n\nTo bring the environment up:\n\n```shell\ndocker-compose up -d\n```\n\nRunning Composer:\n\n```shell\ndocker-compose exec app composer install\n```\n\nSetting up App Key:\n```shell\ndocker-compose exec app artisan key:generate\n```\n\nRunning Migrations and Seeds:\n```shell\ndocker-compose exec app artisan migrate --seed\n```\n\nThen you should be able to access the application on `localhost:8080`.\n\nChange the `links.yml` file to change the links that get seeded into the database by default, when the application is deployed.\n\nTo manage links, use `artisan`:\n\n```shell\ndocker-compose exec app artisan link:list\n```\n\nThis will list all links in the database. To add a new link, use `link:create`, and `link:delete LINK_ID` to delete links.\n\n## Deploying to App Platform via `doctl`\nTo deploy your customized version of this application to DigitalOcean's App Platform, you can use `doctl` with the included App Spec file. \nFirst, edit the `.do/deploy.template.yml` file to change the `github.repo` entries to your own forked repository URL. You may also want to change the `name` of the application. \nThen, run [doctl](https://www.digitalocean.com/docs/apis-clis/doctl/how-to/install/):\n\n```shell\ndoctl apps create --spec .do/deploy.template.yaml\n```\n\nThen go to your App Platform dashboard to follow the build logs.\n\nYou can find more details on how to use `doctl` and the App Spec file in [this post](https://dev.to/erikaheidi/deploying-a-laravel-application-to-digitalocean-app-platform-via-doctl-with-an-app-spec-yaml-file-4dib).\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdo-community%2Flanding-laravel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdo-community%2Flanding-laravel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdo-community%2Flanding-laravel/lists"}