feat: add dedicated install-php playbook and command

app/Console/Server/ServerInstallCommand.php

@@ -33,6 +33,8 @@ protected function configure(): void
         parent::configure();
 
         $this->addOption('server', null, InputOption::VALUE_REQUIRED, 'Server name');
+        $this->addOption('php-version', null, InputOption::VALUE_REQUIRED, 'PHP version to install');
+        $this->addOption('php-default', null, InputOption::VALUE_NONE, 'Set as default PHP version');
     }
 
     // ----
@@ -99,6 +101,20 @@ protected function execute(InputInterface $input, OutputInterface $output): int
 
         $this->yay('Server installed successfully');
 
+        //
+        // Install PHP
+        // ----
+
+        $phpResult = $this->installPhp($server, $info);
+
+        if (is_int($phpResult)) {
+            return $phpResult;
+        }
+
+        /** @var array{status: int, php_version: string, php_default: bool} $phpResult */
+        $phpVersion = $phpResult['php_version'];
+        $phpDefault = $phpResult['php_default'];
+
         //
         // Setup demo site
         // ----
@@ -152,6 +168,8 @@ protected function execute(InputInterface $input, OutputInterface $output): int
 
         $this->showCommandReplay('server:install', [
             'server' => $server->name,
+            'php-version' => $phpVersion,
+            'php-default' => $phpDefault,
         ]);
 
         return Command::SUCCESS;

app/Console/Server/ServerInstallPhpCommand.php

@@ -0,0 +1,97 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Bigpixelrocket\DeployerPHP\Console\Server;
+
+use Bigpixelrocket\DeployerPHP\Contracts\BaseCommand;
+use Bigpixelrocket\DeployerPHP\Traits\PlaybooksTrait;
+use Bigpixelrocket\DeployerPHP\Traits\ServersTrait;
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Input\InputOption;
+use Symfony\Component\Console\Output\OutputInterface;
+
+#[AsCommand(
+    name: 'server:install:php',
+    description: 'Install PHP on a server'
+)]
+class ServerInstallPhpCommand extends BaseCommand
+{
+    use PlaybooksTrait;
+    use ServersTrait;
+
+    // ----
+    // Configuration
+    // ----
+
+    protected function configure(): void
+    {
+        parent::configure();
+
+        $this->addOption('server', null, InputOption::VALUE_REQUIRED, 'Server name');
+        $this->addOption('php-version', null, InputOption::VALUE_REQUIRED, 'PHP version to install');
+        $this->addOption('php-default', null, InputOption::VALUE_NONE, 'Set as default PHP version');
+    }
+
+    // ----
+    // Execution
+    // ----
+
+    protected function execute(InputInterface $input, OutputInterface $output): int
+    {
+        parent::execute($input, $output);
+
+        $this->heading('Install PHP');
+
+        //
+        // Select server & display details
+        // ----
+
+        $server = $this->selectServer();
+
+        if (is_int($server)) {
+            return $server;
+        }
+
+        $this->displayServerDeets($server);
+
+        //
+        // Get server info (verifies SSH connection and validates distribution & permissions)
+        // ----
+
+        $info = $this->getServerInfo($server);
+
+        if (is_int($info)) {
+            return $info;
+        }
+
+        //
+        // Install PHP
+        // ----
+
+        $phpResult = $this->installPhp($server, $info);
+
+        if (is_int($phpResult)) {
+            return $phpResult;
+        }
+
+        /** @var array{status: int, php_version: string, php_default: bool} $phpResult */
+        $phpVersion = $phpResult['php_version'];
+        $phpDefault = $phpResult['php_default'];
+
+        //
+        // Show command replay
+        // ----
+
+        $this->showCommandReplay('server:install:php', [
+            'server' => $server->name,
+            'php-version' => $phpVersion,
+            'php-default' => $phpDefault,
+        ]);
+
+        return Command::SUCCESS;
+    }
+
+}

app/SymfonyApp.php

@@ -12,6 +12,7 @@
 use Bigpixelrocket\DeployerPHP\Console\Server\ServerDeleteCommand;
 use Bigpixelrocket\DeployerPHP\Console\Server\ServerInfoCommand;
 use Bigpixelrocket\DeployerPHP\Console\Server\ServerInstallCommand;
+use Bigpixelrocket\DeployerPHP\Console\Server\ServerInstallPhpCommand;
 use Bigpixelrocket\DeployerPHP\Console\Server\ServerListCommand;
 use Bigpixelrocket\DeployerPHP\Console\Server\ServerLogsCommand;
 use Bigpixelrocket\DeployerPHP\Console\Server\ServerProvisionDigitalOceanCommand;
@@ -144,6 +145,7 @@ private function registerCommands(): void
             ServerListCommand::class,
             ServerInfoCommand::class,
             ServerInstallCommand::class,
+            ServerInstallPhpCommand::class,
             ServerLogsCommand::class,
             ServerRunCommand::class,
 

app/Traits/PlaybooksTrait.php

@@ -53,6 +53,13 @@ protected function executePlaybook(
         $playbookPath = $projectRoot . '/playbooks/' . $playbookName . '.sh';
         $scriptContents = $this->fs->readFile($playbookPath);
 
+        // Prepend helpers.sh content to playbook for remote execution
+        $helpersPath = $projectRoot . '/playbooks/helpers.sh';
+        if (file_exists($helpersPath)) {
+            $helpersContents = $this->fs->readFile($helpersPath);
+            $scriptContents = $helpersContents . "\n\n" . $scriptContents;
+        }
+
         // Unique output file name
         $outputFile = sprintf('/tmp/deployer-output-%d-%s.yml', time(), bin2hex(random_bytes(8)));