Set up a local development environment for Temporal and PHP

Last updated on Mar 27, 2023

Tags:

• PHP
• SDK
• development environment

WORK IN PROGRESS

This tutorial is a work in progress. Some sections may be incomplete, out of date, or missing. We're working to update it.

To follow the PHP SDK tutorials and build your own Temporal applications with PHP, you'll need the PHP SDK, the RoadRunner application server, and a Temporal development server.

Install the PHP SDK

Install the PHP SDK using Composer:

composer require temporal/sdk

Download RoadRunner

See the RoadRunner README file for installation instructions.

Next, you'll configure a local Temporal cluster for development.

Set up a local Temporal development cluster

The fastest way to get a development cluster running on your local machine is to use Temporal CLI.

Temporal CLI is a tool for interacting with a Temporal Cluster from the command-line interface, but it includes a self-contained distribution of the Temporal Server and Web UI as well.

Install Temporal CLI on your local machine using the following instructions for your platform.

macOS

You can install the latest stable version with Homebrew using the following command:

brew install temporal

You can also install Temporal CLI using the installation script. Review the script and then download and install Temporal CLI with the following command:

curl -sSf https://temporal.download/cli.sh | sh

To manually install Temporal CLI, download the version for your architecture:

• Download Temporal CLI for Intel Macs
• Download Temporal CLI for Apple Silicon Macs

Once you've downloaded the file, extract the downloaded archive and add the temporal binary to your PATH by copying it to a directory like /usr/local/bin.

Windows

To install Temporal CLI on Windows, download the version for your architecture:

• Download Temporal CLI for Windows amd64
• Download Temporal CLI for Windows arm64

Once you've downloaded the file, extract the downloaded archive and add the temporal.exe binary to your PATH.

Linux

Install Temporal CLI using the installation script. Review the script and then download and install Temporal CLI with the following command:

curl -sSf https://temporal.download/cli.sh | sh

To manually install Temporal CLI, download the version for your architecture

• Download Temporal CLI for Linux amd64
• Download Temporal CLI for Linux arm64

Once you've downloaded the file, extract the downloaded archive and add the temporal binary to your PATH by copying it to a directory like /usr/local/bin.

Once you've installed Temporal CLI and added it to your PATH, open a new Terminal window and run the following command:

temporal server start-dev

This command automatically starts the Web UI, creates the default Namespace, and uses an in-memory database.

• The Temporal Server will be available on localhost:7233.
• The Temporal Web UI will be available at http://localhost:8233.

Change the Web UI port

The Temporal Web UI may be on a different port in some examples or tutorials. To change the port for the Web UI, use the --ui-port option when starting the server::

temporal server start-dev --ui-port 8080

The Temporal Web UI will now be available at http://localhost:8080.

Leave the cluster running as you work through tutorials and other projects. You can stop the cluster at any time by pressing CTRL+C.

Once you have everything installed, you're ready to build apps with Temporal on your local machine.