Symfony 2.3报错：The 'actions' extension is not enabled 排查求助

刚帮你梳理了几个针对这个报错的核心排查方向，都是结合Symfony 2.1到2.3的版本差异来的，应该能帮你定位问题：

1. 检查Twig扩展的配置是否正确 #

在Symfony 2.1里，actions扩展基本是默认启用的，但升级到2.3后，如果你的config.yml里手动覆盖了Twig的扩展列表，就可能把默认的ActionsExtension给排除了。打开app/config/config.yml，确认FrameworkBundle的ActionsExtension被包含在Twig扩展配置中：

framework:
    # 先确保templating引擎配置了twig
    templating:
        engines: ['twig']
    twig:
        extensions:
            - Symfony\Bundle\FrameworkBundle\Twig\Extension\ActionsExtension
            # 也可以用服务别名：framework.twig.extension.actions

如果之前没手动配置过twig.extensions，那大概率是自动注册的，但如果有自定义扩展列表，一定要加上这一项。

2. 替换模板里的旧{% actions %}标签 #

其实从Symfony 2.3开始，官方就已经废弃了{% actions %}标签，转而推荐使用{{ render() }}函数（或者更早一点的{% render %}标签）。比如你原来的模板代码可能是这样：

{% actions %}
    {% render 'AcmeDemoBundle:Demo:hello' with {'name': 'Anton'} %}
{% endactions %}

直接改成下面的写法就行：

{{ render(controller('AcmeDemoBundle:Demo:hello', {'name': 'Anton'})) }}

这是最常见的原因——旧标签对应的扩展在2.3里默认不再启用了。

3. 确认FrameworkBundle正确注册 #

别小看这个，有时候升级过程中可能误操作修改了AppKernel.php。打开app/AppKernel.php，检查registerBundles()方法里有没有注册FrameworkBundle：

public function registerBundles()
{
    $bundles = array(
        // ... 其他Bundle
        new Symfony\Bundle\FrameworkBundle\FrameworkBundle(),
        // ... 其他Bundle
    );
    // ...
}

如果这个核心Bundle没注册，它的所有Twig扩展（包括ActionsExtension）肯定都加载不了。

4. 清理缓存，避免旧配置残留 #

升级时缓存是重灾区，旧的容器配置可能还在生效。执行下面的命令彻底清理缓存：

php app/console cache:clear --env=dev
php app/console cache:clear --env=prod

清理完再重新访问页面，很多时候这类奇怪的报错都是缓存导致的。

5. 检查Composer依赖版本是否匹配 #

确认你的symfony/framework-bundle确实是2.3.x版本，并且twig/twig的版本符合2.3的要求（大概是~1.12）。可以用下面的命令查看当前版本：

composer show symfony/framework-bundle
composer show twig/twig

如果版本不匹配，比如Twig版本太高或太低，也可能导致扩展加载异常，这时候需要调整composer.json里的依赖版本，再执行composer update。

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