Symfony框架下如何从控制器中调用执行自定义控制台命令？

问题排查与修复方案 #

路由配置说明 #

你已经通过注解配置了控制器路由前缀/api/import和方法路由/upload，只要你的Symfony项目开启了注解路由支持（框架默认开启），不需要额外在yaml/xml配置文件中定义路由，可执行命令php bin/console debug:route查看是否存在/api/import/upload路由，确认路由是否注册成功。

命令无响应的常见原因和修复方案 #

• 环境差异问题
  控制台执行命令默认走dev环境，控制器调用默认走当前请求的环境（通常是prod），不同环境的数据库配置、命令可用状态可能存在差异，可在调用时指定和控制台一致的环境：

$input = new ArrayInput([
    'command' => 'app:import-database',
    '--env' => 'dev' // 和你控制台执行时的环境保持一致
]);

• 执行超时问题
  数据库导入属于耗时操作，web请求默认的PHP执行时间上限max_execution_time通常只有30秒，控制台执行无此限制，很容易超时被中断，可在方法开头解除执行时间限制：

set_time_limit(0); // 仅对当前请求生效

• 错误捕获缺失
  原有代码没有捕获执行异常，命令报错也无法感知，可增加异常捕获逻辑定位问题，优化后的完整代码如下：

<?php

namespace App\Controller;

use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;

use Symfony\Bundle\FrameworkBundle\Console\Application;
use Symfony\Component\Console\Input\ArrayInput;
use Symfony\Component\Console\Output\BufferedOutput;

/**
* @Route("/api/import")
*/
class ImportController extends AbstractController
{
    /**
     * @Route("/upload")
     */
    public function upload()
    {
        set_time_limit(0);
        try {
            $kernel = $this->get('kernel');
            $application = new Application($kernel);
            $application->setAutoExit(false);

            $input = new ArrayInput([
                'command' => 'app:import-database',
                '--env' => 'dev'
            ]);
            // 若命令需要交互可开启下面配置避免卡住
            // $input->setInteractive(false);

            $output = new BufferedOutput();
            $statusCode = $application->run($input, $output);
            $content = $output->fetch();

            if ($statusCode !== 0) {
                return new Response('命令执行失败，错误信息：'.$content, 500);
            }
            return new Response('执行成功，输出：'.$content);
        } catch (\Exception $e) {
            return new Response('调用异常：'.$e->getMessage(), 500);
        }
    }
}

• 权限不足问题
  web请求的执行用户（通常是www-data、apache）和控制台执行命令的用户权限不同，如果导入命令涉及本地文件读写，需要确认web执行用户对对应文件/目录有读写权限。

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