When you develop a Symfony project, a significant amount of work takes place
locally rather than on an active Upsun environment. You want to ensure
that the process of local development is as close as possible to a deployed
environment.
You can achieve this through various approaches. For example, you can use
Symfony Server with tethered data.
To do so, when testing changes locally, you can connect your locally running
Symfony Server to service containers on an active Upsun environment.
This methodology has several advantages:
- It avoids installing anything on your local machine but PHP;
- It ensures that you are using the same versions of all services on your local
machine and in production.
Warning
Never use this method on the main environment as changes made on your local
machine will impact production data.
1. Start your Symfony Server
To start your Symfony
Server locally and
display your Symfony app, run the following command:
symfony server:start -d
symfony open:local
2. Create the tethered connection
-
Create a new environment off of production:
symfony branch new-feature main
-
Open an SSH tunnel to the new environment’s services:
This command returns the addresses for SSH tunnels to all of your services:
symfony tunnel:open
SSH tunnel opened to rediscache at: redis://127.0.0.1:30000
SSH tunnel opened to database at: pgsql://main:main@127.0.0.1:30001/main
Logs are written to: /Users/acmeUser/.platformsh/tunnels.log
List tunnels with: symfony tunnels
View tunnel details with: symfony tunnel:info
Close tunnels with: symfony tunnel:close
Save encoded tunnel details to the PLATFORM_RELATIONSHIPS variable using:
export PLATFORM_RELATIONSHIPS="$(symfony tunnel:info --encode)"
-
To expose Upsun services to your Symfony app, run the following
command:
symfony var:expose-from-tunnel
-
When you’ve finished your work,
close the tunnels to your services by running the following command:
symfony var:expose-from-tunnel --off
symfony tunnel:close --all -y
