{"id":20329346,"url":"https://github.com/ddev/ddev-platformsh","last_synced_at":"2025-10-24T08:44:20.183Z","repository":{"id":37908896,"uuid":"489460881","full_name":"ddev/ddev-platformsh","owner":"ddev","description":"Add integration with Platform.sh hosting service","archived":false,"fork":false,"pushed_at":"2025-04-10T19:54:21.000Z","size":600,"stargazers_count":10,"open_issues_count":20,"forks_count":11,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-04-10T20:47:41.532Z","etag":null,"topics":["ddev-get"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/ddev.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},"funding":{"github":["ddev"],"custom":["https://www.paypal.com/donate/?hosted_button_id=MCNCSZHC7LHSQ","https://ddev.com/support-ddev/"]}},"created_at":"2022-05-06T18:45:51.000Z","updated_at":"2025-04-10T19:52:43.000Z","dependencies_parsed_at":"2023-02-19T10:01:02.025Z","dependency_job_id":"58f82020-3da1-4655-8309-f6dee86cc166","html_url":"https://github.com/ddev/ddev-platformsh","commit_stats":null,"previous_names":[],"tags_count":26,"template":false,"template_full_name":"ddev/ddev-addon-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddev%2Fddev-platformsh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddev%2Fddev-platformsh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddev%2Fddev-platformsh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddev%2Fddev-platformsh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ddev","download_url":"https://codeload.github.com/ddev/ddev-platformsh/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248478879,"owners_count":21110777,"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":["ddev-get"],"created_at":"2024-11-14T20:10:15.501Z","updated_at":"2025-10-24T08:44:20.117Z","avatar_url":"https://github.com/ddev.png","language":"Shell","funding_links":["https://github.com/sponsors/ddev","https://www.paypal.com/donate/?hosted_button_id=MCNCSZHC7LHSQ","https://ddev.com/support-ddev/"],"categories":[],"sub_categories":[],"readme":"[![add-on registry](https://img.shields.io/badge/DDEV-Add--on_Registry-blue)](https://addons.ddev.com)\n[![tests](https://github.com/ddev/ddev-platformsh/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/ddev/ddev-platformsh/actions/workflows/tests.yml?query=branch%3Amain)\n[![last commit](https://img.shields.io/github/last-commit/ddev/ddev-platformsh)](https://github.com/ddev/ddev-platformsh/commits)\n[![release](https://img.shields.io/github/v/release/ddev/ddev-platformsh)](https://github.com/ddev/ddev-platformsh/releases/latest)\n\n# DDEV Platform.sh\n\n## Overview\n\n[Platform.sh](https://platform.sh/) is a unified, secure, enterprise-grade platform for building, running and scaling web applications.\n\nThis repository is used with `ddev add-on get ddev/ddev-platformsh` to get a rich integration between your checked-out Platform.sh project and [DDEV](https://ddev.com).\n\n## Using with a Platform.sh project\n\n### Dependencies\n\nMake sure you have [DDEV v1.24.3+ installed](https://ddev.readthedocs.io/en/stable/users/install/ddev-installation/)\n\n### Install\n1. Clone your project repository (e.g. `platform get \u003cprojectid\u003e`)\n2. `cd` into your project directory\n3. Run `ddev config` and answer the questions as appropriate\n4. Run `ddev add-on get ddev/ddev-platformsh` and answer the questions as appropriate\n5. Run `ddev start`\n6. (Optional) Run `ddev pull platform` to retrieve a copy of the database and contents from the project's file mounts from the environment you entered in step #5. (If you only want to retrieve the database (skipping the file mounts), add the `--skip-files` flag to the `ddev pull platform` command.)\n\n### Upgrade\n\nTo upgrade your version of ddev-platformsh, repeat the `ddev add-on get ddev/ddev-platformsh` to get the latest release. To see the installed version, `ddev add-on list --installed`.\n\n### Run it again if you change your Platform.sh configuration\n\nIf you change your `.platform.app.yaml` or something in your `.platform` directory, repeat the `ddev add-on get ddev/ddev-platformsh` so that the generated configuration for DDEV will be updated.\n\n## Notes\n\n* If your local project has a different database type than the upstream (Platform.sh) database, it will conflict, so please back up your database with `ddev export-db` and `ddev delete` before starting the project with new config based on upstream.\n* Your experience is super-important: Please let us know about how it went for you in any of the [DDEV support venues](https://ddev.readthedocs.io/en/stable/users/support/)\n\n## What does it do right now?\n\n* Works with many projects of type `php`, for example, `php:8.2` or `php:8.3`. It does not work with non-php projects.\n* Takes your checked-out Platform.sh project and configures DDEV based on that information.\n    * PHP and Database version\n    * Hooks are converted to DDEV post-start hooks\n    * A working `ddev pull platform` integration with all mounts is created.\n    * Exposes specific `$PLATFORM_` variables (e.g., `$PLATFORM_RELATIONSHIPS`, `$PLATFORM_ROUTES`)\n* Supports the following services:\n    * Databases\n      * MariaDB\n      * Oracle MySQL\n      * PostgreSQL\n    * Redis\n    * Redis-persistent\n    * Memcached\n    * Elasticsearch\n* Provides the following [Platform.sh-provided environmental variables](https://docs.platform.sh/development/variables/use-variables.html#use-platformsh-provided-variables):\n  * PLATFORM_APP_DIR\n  * PLATFORM_APPLICATION_NAME\n  * PLATFORM_CACHE_DIR\n  * PLATFORM_ENVIRONMENT\n  * PLATFORM_PROJECT\n  * PLATFORM_PROJECT_ENTROPY\n  * PLATFORM_RELATIONSHIPS\n  * PLATFORM_ROUTES\n  * PLATFORM_TREE_ID\n  * PLATFORM_VARIABLES\n\n## What has been tested\n\nThese Platform.sh templates are included in the automated tests that run nightly. They will be growing in maturity with your feedback!\n\n* [php](https://github.com/platformsh-templates/php)\n* [drupal9](https://github.com/platformsh-templates/drupal9), [drupal10](https://github.com/platformsh-templates/drupal10), [drupal11](https://github.com/platformsh-templates/drupal11)\n* [laravel](https://github.com/platformsh-templates/laravel)\n* [magento2ce](https://github.com/platformsh-templates/magento2ce)\n* [wordpress-composer](https://github.com/platformsh-templates/wordpress-composer)\n\n(Each of the above but magento2ce has automated tests.)\n\n## What will it do in the future\n\n- [x] Populate important PLATFORMSH environment variables that would be found upstream\n- [x] Populate PHP and other dependencies configured upstream\n- [x] Automatically figure out the name and other information of the upstream project\n- [x] Automatically configure the .ddev/providers/platform so you can immediately do a `ddev pull platform` with no configuration effort.\n- [ ] Let us know what's important to you!\n\n## Credits\n\n**Maintained by [@rfay](https://github.com/rfay)**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fddev%2Fddev-platformsh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fddev%2Fddev-platformsh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fddev%2Fddev-platformsh/lists"}