middlewares / debugbar
中间件,自动将PHP DebugBar插入到HTML响应中
v2.1.1
2024-03-21 14:50 UTC
Requires
- php: ^7.2 || ^8.0
- maximebf/debugbar: ^1.13
- middlewares/utils: ^3.0 || ^4.0
- psr/http-server-middleware: ^1.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^2.0
- laminas/laminas-diactoros: ^2.3
- oscarotero/php-cs-fixer-config: ^1.0
- phpstan/phpstan: ^0.12
- phpunit/phpunit: ^8|^9
- squizlabs/php_codesniffer: ^3.0
README
中间件,自动将 PHP DebugBar 插入到HTML响应中。
要求
- PHP >= 7.2
- PSR-7 http库
- PSR-15中间件分发器
安装
此软件包可以通过Composer安装和自动加载,名称为 middlewares/debugbar。
composer require middlewares/debugbar
示例
$dispatcher = new Dispatcher([ new Middlewares\Debugbar() ]); $response = $dispatcher->dispatch(new ServerRequest());
用法
您可以将一个 DebugBar\DebugBar
实例传递给构造函数,或者系统将自动创建一个 DebugBar\StandardDebugBar
实例。可选地,您也可以提供 Psr\Http\Message\ResponseFactoryInterface
和 Psr\Http\Message\StreamFactoryInterface
以创建新的响应。如果没有定义,将使用 Middleware\Utils\Factory 自动检测。
//Create a StandardDebugBar automatically $debugbar = new Middlewares\Debugbar(); //Use other Debugbar instance $debugbar = new Middlewares\Debugbar($myDebugbar); //Use other Debugbar instance and PSR-17 factories $debugbar = new Middlewares\Debugbar($myDebugbar, $myResponseFactory, $myStreamFactory);
captureAjax
使用此选项捕获Ajax请求并将数据发送到头部。有关Ajax和堆叠数据的更多信息,请参阅 更多详情。默认情况下,此选项已禁用。
$debugbar = (new Middlewares\Debugbar())->captureAjax();
inline
将此设置为true,将在HTML中内联输出js/css代码。这可以解决(或减轻)与加载debugbar资源相关的一些问题。
$debugbar = (new Middlewares\Debugbar())->inline();
renderOptions
使用此选项将渲染选项以数组形式传递给debugbar。可在 此处 找到可用的选项列表。
一个示例用法是传递新的 base_url
位置,以便可以重写渲染debug bar所需的文件的位置。这可以与符号链接、.htaccess或路由到文件的路径一起使用,以确保debugbar文件可访问。
$debugbar = (new Middlewares\Debugbar())->renderOptions(array('base_url' => "/MyProjectsSubDirectory/maximebf/debugbar/"));
有关最近更改的更多信息,请参阅 CHANGELOG,有关贡献的详细信息,请参阅 CONTRIBUTING。
MIT许可证(MIT)。有关更多信息,请参阅 LICENSE。