phpdesktop中Laravel应用AJAX请求/api/resource报404问题求助

Hey there! Let's tackle this Laravel + phpdesktop API 404 issue together — I’ve dealt with this exact quirk before, so I’m confident we can get your app running smoothly locally without a separate web server. The problem happens because phpdesktop’s built-in PHP server handles routing a bit differently than php artisan serve, but it’s totally fixable. Here are the key steps to try:

1. Adjust Your Axios Base URL #

When you run the packaged app via phpdesktop, your app’s root URL isn’t http://localhost:8000 anymore — it might be a local file path or a random port assigned by phpdesktop. If your Axios requests are hardcoded to http://localhost:8000/api, they’ll fail every time.

Instead, use a dynamic base URL that adapts to the current environment:

// In your Vue main.js or Axios config file
axios.defaults.baseURL = window.location.origin + '/api';
// Or even simpler, use a relative path directly:
// axios.defaults.baseURL = '/api';

This ensures Axios always points to the correct API endpoint regardless of how the app is launched.

2. Correct phpdesktop's Server Settings #

Head to your phpdesktop project’s settings.json file — this is where most configuration issues live. Pay close attention to these two critical settings:

Document Root #

Make sure document_root points directly to Laravel’s public folder (not your project root!). Laravel’s entry point is public/index.php, so pointing to the wrong directory will break routing:

"web_server": {
  "php_executable": "php/php.exe",
  "document_root": "public", // *This is key!*
  "listen_on": "127.0.0.1",
  "port": 0, // 0 uses a random free port (recommended)
  "php_ini_path": "php/php.ini"
}

Add a Router Script #

PHP’s built-in server doesn’t natively support Apache-style .htaccess rules (which Laravel uses to route all requests to index.php). To fix this, create a router.php file in your Laravel public folder:

<?php
// public/router.php
if (php_sapi_name() === 'cli-server') {
    $uri = urldecode(parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH));
    // Let the server handle actual files (like CSS/JS) directly
    if ($uri !== '/' && file_exists(__DIR__ . $uri)) {
        return false;
    }
}
// Forward all other requests to Laravel's index.php
require_once __DIR__ . '/index.php';

Then update settings.json to use this router:

"web_server": {
  // ... other settings
  "router_script": "public/router.php"
}

This replicates the routing logic that php artisan serve uses by default.

3. Verify Laravel's API Route Setup #

Double-check that your API routes are defined in routes/api.php and that Laravel’s RouteServiceProvider is applying the /api prefix correctly. Open app/Providers/RouteServiceProvider.php and confirm this method exists:

protected function mapApiRoutes()
{
    Route::prefix('api')
          ->middleware('api')
          ->namespace($this->namespace)
          ->group(base_path('routes/api.php'));
}

This is Laravel’s default setup, but if it’s been modified, your API routes won’t be accessible at the /api path.

4. Test with Absolute Paths (If Needed) #

Occasionally, phpdesktop struggles with relative paths. If you’re still having issues, try setting an absolute path for document_root in settings.json:

"document_root": "C:/path/to/your/laravel/app/public"
// Or for macOS/Linux:
// "document_root": "/home/youruser/laravel-app/public"

This is absolutely not an unavoidable limitation — it’s just a matter of aligning phpdesktop’s configuration with Laravel’s routing requirements. Once you make these adjustments, your Axios API requests should work just as smoothly in the packaged app as they do with php artisan serve.

内容的提问来源于stack exchange，提问作者Beefjeff