{"id":16438769,"url":"https://github.com/theomessin/laravel-devcontainer","last_synced_at":"2025-09-02T01:32:32.842Z","repository":{"id":44757838,"uuid":"256491790","full_name":"theomessin/laravel-devcontainer","owner":"theomessin","description":"🐋 Fully-Dockerised Laravel development in Visual Studio Code","archived":false,"fork":false,"pushed_at":"2024-07-02T02:07:12.000Z","size":12,"stargazers_count":127,"open_issues_count":5,"forks_count":31,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-12-22T11:08:33.423Z","etag":null,"topics":["container","devcontainer","docker","laravel","php","remote","vscode"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","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/theomessin.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-04-17T12:05:27.000Z","updated_at":"2024-12-20T10:01:32.000Z","dependencies_parsed_at":"2024-11-17T00:19:24.579Z","dependency_job_id":null,"html_url":"https://github.com/theomessin/laravel-devcontainer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theomessin%2Flaravel-devcontainer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theomessin%2Flaravel-devcontainer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theomessin%2Flaravel-devcontainer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theomessin%2Flaravel-devcontainer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/theomessin","download_url":"https://codeload.github.com/theomessin/laravel-devcontainer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":231732274,"owners_count":18418179,"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":["container","devcontainer","docker","laravel","php","remote","vscode"],"created_at":"2024-10-11T09:06:10.664Z","updated_at":"2024-12-29T12:13:21.189Z","avatar_url":"https://github.com/theomessin.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"### Laravel Development Containers for Visual Studio Code\n\n`laravel-devcontainer` is a simple configuration to support fully-dockerised development of Laravel applications using Visual Studio Code.\nUnlike Laravel Sail, `laravel-devcontainer` has been built so that the entire development experience is dockerised. The only requirements are:\n\n- [Visual Studio Code](https://code.visualstudio.com/)\n- [Visual Studio Code Remote Containers Extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)\n- [Docker](https://docs.docker.com/get-docker/)\n- [Docker Compose](https://docs.docker.com/compose/install/)\n\nVisual Studio Code will actually run inside a Docker container with php-cli as well as other development tools.\nAny Extensions will also run in the same container, meaning that intellisense will use the same php-cli configuration!\n\n`laravel-devcontainer` currently ships with:\n\n- `php:8.3-cli-alpine` workspace with composer, pgsql, redis, and nodejs.\n- `php:8.3-fpm-alpine` container with pgsql and redis extensions.\n- `nginx:1.27-alpine` preconfigured for your Laravel application.\n- `postgres:16.3-alpine` preconfigured with the default Laravel credentials.\n- `redis:7.2-alpine` for caching, queues, sessions, etc.\n\n#### Easy Installation\n\nUsing this configuration is quite simple. [Download](https://github.com/theomessin/laravel-devcontainer/archive/refs/heads/master.zip) and place `laravel-devcontainer` in a `.devcontainer` folder with your Laravel Code. If starting a new project, you may create a new folder with just `laravel-devcontainer` in your `.devcontainer` folder. You may then [install Laravel using Composer](https://laravel.com/docs/11.x/installation#creating-a-laravel-project) (e.g. under `example-app`). You may then move the `.devcontainer` folder to your code folder (`mv .devcontainer example-app`) and use that!\n\n#### Installing Using Git Submodules\n\nAlternatively, you may use [Git Submodules](https://git-scm.com/book/en/v2/Git-Tools-Submodules). Install the configuration by running\n\n```sh\ngit submodule add https://github.com/theomessin/laravel-devcontainer .devcontainer\n```\n\nIf you use this method, do not forget to install submodules when cloning:\n\n```\ngit clone --recurse-submodules ...\n```\n\n#### Usage\n\nStart Visual Studio Code (e.g. `code example-app`) and re-open in remote containers (`Remote-Containers: Reopen in Container`). This may take some time on the first use, as Docker initially downloads and builds the images. Eventually, Visual Studio Code will run inside the workspace container. Extensions and settings specified in `devcontainer.json` will be auto-configured!\n\nBe sure to correctly configure your application `.env` to use the devcontainer postgres and redis. For example:\n\n```env\nDB_CONNECTION=pgsql\nDB_HOST=postgres\nDB_PORT=5432\nDB_DATABASE=laravel\nDB_USERNAME=root\nDB_PASSWORD=\n\nREDIS_HOST=redis\nREDIS_PASSWORD=null\nREDIS_PORT=6379\n```\n\nYou may then navigate to [`localhost`](http://localhost) on your local machine. Fingers crossed, you will see your Laravel application!\nRun any artisan or composer commands using the Visual Studio Code [Integrated Terminal](https://code.visualstudio.com/docs/editor/integrated-terminal).\nAs such, you do not need anything else installed on your host machine!\n\n#### Extensions\n\n`laravel-devcontainer` currently ships with the following extensions for Laravel development in Visual Studio Code:\n\n- [\"bmewburn.vscode-intelephense-client\"](https://marketplace.visualstudio.com/items?itemName=bmewburn.vscode-intelephense-client)\n- [\"eamodio.gitlens\"](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens)\n- [\"EditorConfig.EditorConfig\"](https://marketplace.visualstudio.com/items?itemName=EditorConfig.EditorConfig)\n- [\"mikestead.dotenv\"](https://marketplace.visualstudio.com/items?itemName=mikestead.dotenv)\n- [\"onecentlin.laravel-blade\"](https://marketplace.visualstudio.com/items?itemName=onecentlin.laravel-blade)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheomessin%2Flaravel-devcontainer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheomessin%2Flaravel-devcontainer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheomessin%2Flaravel-devcontainer/lists"}