Yii2中Bootstrap模态框按钮渲染至外部的原因及解决方法

你的代码存在两个核心问题导致按钮重复出现：

1. 重复渲染模态框：Yii2的Modal::begin()和Modal::end()是一套完整的输出流程——begin()开启输出缓冲，中间内容会被作为模态框主体，end()会关闭缓冲并直接输出完整模态框HTML。但你额外调用了$modal->run()，这会再次渲染一遍模态框，导致内容重复输出。
2. 用法混淆：同时混用begin()/end()缓冲输出和面向对象的run()方法，破坏了模态框的渲染逻辑，导致部分内容（比如按钮）意外暴露在页面中。

方式一：标准begin()/end()流程（推荐） #

这是Yii2官方推荐的用法，无需手动调用run()，也不需要存储begin()的返回值：

<?php
use yii\bootstrap4\Modal;
use yii\helpers\Html;

// 定义按钮（变量存储HTML字符串，不会直接输出）
$confirmBtn = Html::submitButton('确认', ['class' => 'btn btn-primary']);
$cancelBtn = Html::button('取消', ['class' => 'btn btn-secondary', 'data-dismiss' => 'modal']);

// 初始化模态框并配置参数
Modal::begin([
    'title' => '确认操作',
    'footer' => $cancelBtn . ' ' . $confirmBtn,
    // 配置触发按钮，也可以手动通过JS触发
    'toggleButton' => ['label' => '打开确认框', 'class' => 'btn btn-warning'],
]);

// 模态框主体内容
echo '你确定要执行该操作吗？';

// 结束模态框，自动输出完整HTML
Modal::end();

方式二：纯面向对象构建（适合动态场景） #

如果需要动态控制模态框属性，不要混用begin()/end()，直接通过实例化构建：

<?php
use yii\bootstrap4\Modal;
use yii\helpers\Html;

$modal = new Modal([
    'title' => '确认操作',
    'body' => '你确定要执行该操作吗？',
    'footer' => Html::button('取消', ['class' => 'btn btn-secondary', 'data-dismiss' => 'modal']) . ' ' .
                Html::submitButton('确认', ['class' => 'btn btn-primary']),
    'toggleButton' => ['label' => '打开确认框', 'class' => 'btn btn-warning'],
]);

// 仅调用一次run()输出模态框
echo $modal->run();

• 取消按钮建议用Html::button()而非submitButton，并添加data-dismiss="modal"属性，点击后直接关闭模态框，避免误触表单提交。
• 若模态框嵌套在表单内，需注意表单提交的逻辑隔离，防止意外提交整个表单。

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