Global Laravel Remote Laravel Package

Product Decisions This Supports

• Remote Command Execution: Enables running Artisan commands (e.g., migrate, queue:work, schedule:run) on remote Laravel servers without SSH access, reducing manual intervention and human error.
• DevOps Automation: Supports CI/CD pipelines by allowing automated server-side tasks (e.g., deployments, cache clearing) to be triggered via API/webhooks.
• Multi-Environment Management: Simplifies managing staging/production environments by centralizing command execution from a single dashboard or script.
• Build vs. Buy: Avoids reinventing secure remote command execution logic; leverages Spatie’s battle-tested package for reliability.
• Use Cases:
  • Triggering post-deployment tasks (e.g., optimize:clear, config:cache) via API calls.
  • Running scheduled maintenance tasks (e.g., queue:flush) programmatically.
  • Integrating with monitoring tools to auto-remediate issues (e.g., restarting queues).

When to Consider This Package

• Adopt if:
  • Your Laravel app requires remote command execution without SSH access (e.g., cloud-hosted servers, shared hosting).
  • You need to automate server-side tasks via APIs/webhooks (e.g., post-deploy hooks, monitoring triggers).
  • Your team lacks direct server access but needs to run Artisan commands (e.g., staging environments managed by ops).
• Look elsewhere if:
  • You already have SSH access and prefer direct command execution (e.g., via ssh or Ansible).
  • Your use case requires complex workflows (e.g., multi-step scripts with conditional logic)—consider custom scripts or orchestration tools like Laravel Horizon or Telescope.
  • Security concerns prevent exposing command endpoints (e.g., public APIs); evaluate VPN/SSH tunneling or private API gateways instead.

How to Pitch It (Stakeholders)

For Executives: "This package lets us automate server tasks (like deployments or maintenance) without manual SSH logins, cutting downtime and errors. For example, after a deploy, we can trigger php artisan optimize via an API call—no more forgotten steps. It’s lightweight, secure (MIT-licensed), and maintained by Spatie, a trusted open-source vendor. Low risk, high ROI for DevOps efficiency."

For Engineering: *"Spatie’s global-laravel-remote provides a secure, HTTP-based way to run Artisan commands remotely. Key benefits:

• No SSH needed: Execute commands via API (e.g., POST /remote-command with a signed payload).
• Example: Trigger a queue restart after a deploy with:

  $response = Http::post('https://your-app.com/remote-command', [
      'command' => 'queue:restart',
      'signature' => 'your-signed-hash'
  ]);
  

• Security: Uses signed requests to prevent abuse (configurable in .env).
• Integration: Works with Laravel’s existing command system—no refactoring needed. Tradeoff: Adds a small API endpoint; evaluate if your infrastructure can host it securely (e.g., behind auth middleware)."*