{"id":16871881,"url":"https://github.com/luislavena/hydrofoil-php","last_synced_at":"2026-02-21T14:31:24.096Z","repository":{"id":39922177,"uuid":"460551055","full_name":"luislavena/hydrofoil-php","owner":"luislavena","description":"Opinionated, PHP environment tailored for development","archived":false,"fork":false,"pushed_at":"2026-02-10T12:03:02.000Z","size":145,"stargazers_count":3,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-10T16:52:58.888Z","etag":null,"topics":["container-image","development","php"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/luislavena.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"luislavena"}},"created_at":"2022-02-17T18:04:54.000Z","updated_at":"2026-02-10T12:03:03.000Z","dependencies_parsed_at":"2023-12-20T08:45:40.879Z","dependency_job_id":"2fc1324e-fc56-40a0-b575-15d002a71889","html_url":"https://github.com/luislavena/hydrofoil-php","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/luislavena/hydrofoil-php","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luislavena%2Fhydrofoil-php","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luislavena%2Fhydrofoil-php/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luislavena%2Fhydrofoil-php/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luislavena%2Fhydrofoil-php/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/luislavena","download_url":"https://codeload.github.com/luislavena/hydrofoil-php/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luislavena%2Fhydrofoil-php/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29683899,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T14:31:22.911Z","status":"ssl_error","status_checked_at":"2026-02-21T14:31:22.570Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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-image","development","php"],"created_at":"2024-10-13T15:10:05.158Z","updated_at":"2026-02-21T14:31:24.083Z","avatar_url":"https://github.com/luislavena.png","language":"Dockerfile","funding_links":["https://github.com/sponsors/luislavena"],"categories":[],"sub_categories":[],"readme":"# Hydrofoil (PHP)\n\u003e Opinionated, PHP environment tailored for development\n\n## Features\n\n* Use Debian as base for dev/prod environment parity (following [Twelve-Factor App][twelve-factor-app])\n* Use Docker's official PHP images\n* Promote non-root container usage and proper file/directory ownership\n* Provide simple tools to certain dev related tasks (Eg. watch changes, process monitoring, etc)\n* Be continuously updated using GitHub Actions\n\nThis project does **not** aim to:\n\n* Be compatible with [Visual Studio Code devcontainer][devcontainer], [GitHub Codespaces][codespaces] or similar\n* Be _everything but the kitchen sink_\n\n## Overview\n\nThis project aims to be used **only for development**, replacing the local\ninstallation of tools for something consistent across OS and configurations.\n\nIt includes a base set of PHP extensions for development of average web \napplications, specially for using frameworks like Laravel and\n[Twill CMS][twill-cms], leaving to you the option to add additional\nones by using the offered image as base.\n\nTo be a functional image, it includes the following packages:\n\n* [Composer](https://getcomposer.org/): PHP defacto package manager, aligned with PHP releases\n* [NodeJS](https://nodejs.org/en/): the LTS version at the moment that aligned with PHP's release (Eg. v14 for PHP 7.4, v16 for PHP 8.0, etc)\n* [pnpm](https://pnpm.io/): alternate NodeJS package manager (recommended by newer tooling like Vue 3, Vite 4, etc)\n* [Classic Yarn](https://classic.yarnpkg.com/lang/en/): to allow bootstrapping on projects that haven't switched to Yarn 2\n\nAdditionally, it includes the following packages:\n\n* [fixuid](https://github.com/boxboat/fixuid): tweaks container UID/GID to avoid ownership issues on mounted volumes\n* [Overmind](https://github.com/DarthSim/overmind): Advanced Procfile-based process manager\n* [watchexec](https://github.com/watchexec/watchexec): simple tool that watches a path and runs a command whenever it detects modifications\n\n## Support matrix\n\nThis project will continuously build container images only for the supported\nversions listed below:\n\n| Status      | Versions |\n| ----------- | -------- |\n| Supported   | [![](https://img.shields.io/badge/8.4-green)][package-registry] [![](https://img.shields.io/badge/8.3-green)][package-registry] [![](https://img.shields.io/badge/8.2-green)][package-registry] [![](https://img.shields.io/badge/8.1-green)][package-registry] |\n| Unsupported | [![](https://img.shields.io/badge/8.0-red)][package-registry] [![](https://img.shields.io/badge/7.4-red)][package-registry] [![](https://img.shields.io/badge/7.3-red)][package-registry] |\n\nNote that unsupported means no new builds will be produced for these versions\nas those might have reached EOL (End Of Life) support by PHP developers.\n\n## Requirements\n\nThe container images can be used directly with [Docker][docker], but is\nrecommended to use in combination with [docker-compose][docker-compose].\n\nSee below for usage examples.\n\n## Usage\n\nTo take full advantage of this container image, you need to adjust your\n[`docker-compose.yml`][docker-compose-yml] primary service to use it:\n\n```yaml\nservices:\n  app:\n    image: ghcr.io/luislavena/hydrofoil-php:8.2\n    command: overmind start -f Procfile.dev\n    working_dir: /app\n\n    # Set these env variables using `export FIXUID=$(id -u) FIXGID=$(id -g)`\n    user: ${FIXUID:-1000}:${FIXGID:-1000}\n\n    volumes:\n      - .:/app:cached\n```\n\nLet's break down each element:\n\n```yaml\ncommand: overmind start -f Procfile.dev\n```\n\nThe container will execute Overmind process manager and start the processes\nindicated in the `Procfile.dev` file.\n\n```yaml\nworking_dir: /app\n```\n\nIt adjusts the container working directory to be anything other than the\ndefault. This `/app` location will be used to _mount_ our application code.\n\n```yaml\nuser: ${FIXUID:-1000}:${FIXGID:-1000}\n```\n\nThis sets the user that will be used within the container to something other\nthan `root`. A sudoers `user` has been setup and this instructions uses\nDocker's compose [variable substitution][variable-substitution] to read your\ncurrent user's UID/GID values and map correctly to the container user.\n\nThis technique helps eliminate root/non-root permission issues when working\nwith mounted directories.\n\nIs recommended you `export` these two variables (perhaps in your\nbash profile):\n\n```bash\nexport FIXUID=$(id -u) FIXGID=$(id -g)\n```\n\nFinally, we have the mounted directories:\n\n```yaml\nvolumes:\n  .:/app:cached\n```\n\nThis mounts your current directory as `/app` within the container. Combined\nwith `working_dir` makes it the working directory for all operations.\n\n### Other examples\n\nFor a complete example on how this is being used, check out the\n[Laravel + Twill][laravel-twill] template repository.\n\n## Contribution Policy\n\nThis project is open to code contributions for bug fixes only. Features carry\na long-term maintenance burden so they will not be accepted at this time.\nPlease [submit an issue][new-issue] if you have a feature you'd like to\nrequest or discuss.\n\n[twelve-factor-app]: https://12factor.net/dev-prod-parity\n[devcontainer]: https://code.visualstudio.com/docs/remote/containers\n[codespaces]: https://github.com/features/codespaces\n[twill-cms]: https://twill.io\n[new-issue]: https://github.com/luislavena/hydrofoil-php/issues/new\n[docker]: https://docs.docker.com/get-docker/\n[docker-compose]: https://docs.docker.com/compose/\n[docker-compose-yml]: https://docs.docker.com/compose/compose-file/compose-file-v3/\n[variable-substitution]: https://docs.docker.com/compose/compose-file/compose-file-v3/#variable-substitution\n[laravel-twill]: https://github.com/luislavena/template-laravel-twill\n[package-registry]: https://github.com/luislavena/hydrofoil-php/pkgs/container/hydrofoil-php\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluislavena%2Fhydrofoil-php","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fluislavena%2Fhydrofoil-php","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluislavena%2Fhydrofoil-php/lists"}