入门 Blackfire

入门Blackfire应该少于5分钟 而这个文件将指导您完成安装步骤：

  1. 请检查您的系统满足Blackfire的要求;
  2. 安装PHP扩展和代理;
  3. 配置系统;
  4. 开始分析您的应用程序。

如果停留在这个过程中，有一个看 故障排除部分或联系我们的支持。

在我们开始之前，一定要明白，Blackfire是由重要的是五个主要部分组成：

先决条件

在安装之前Blackfire，请确保您的系统满足以下技术要求：

安装

Blackfire是本身可以在很多平台上 ; 配置是他们更容易：

Ubuntu的/薄荷

](https://blackfire.io/getting-started#installation)
* [红帽

Fedora的/ CentOS的

](https://blackfire.io/getting-started#installation)
* [MacOS的

](https://blackfire.io/getting-started#installation)
* [视窗

](https://blackfire.io/getting-started#installation)
* [码头工人

](https://blackfire.io/getting-started#installation)
* [厨师

](https://blackfire.io/getting-started#installation)
* [手动安装

](https://blackfire.io/getting-started#installation)

在Debian使用Blackfire

快速链接：

配置Debian的仓库

Blackfire使用自定义库的Debian发行自己的包; 它是一个像Ubuntu和Linux的薄荷大多数基于Debian的发行版兼容。

注册packagecloud关键：

wget -O - https://packagecloud.io/gpg.key | sudo apt-key add -

Add deb http://packages.blackfire.io/debian any main to/etc/apt/sources.list.d/blackfire.list:

echo "deb http://packages.blackfire.io/debian any main" | sudo tee /etc/apt/sources.list.d/blackfire.list

更新资料库：

sudo apt-get update

安装代理

安装blackfire-agent包装：

sudo apt-get install blackfire-agent

一旦代理已经安装，配置Blackfire凭据：

sudo blackfire-agent -register

此命令会询问你的Blackfire 服务器凭据，请登录或注册现在：

登录 或 注册

代理服务

在代理安装，一个新的/etc/init.d/blackfire-agent 服务的创建启动，停止和重新启动它。

注册的代理，只要您修改其配置后，必须重新启动它的服务：

sudo /etc/init.d/blackfire-agent restart

如果出现问题，请在默认情况下生成的日志文件/var/log/blackfire/agent.log（您可以更改日志文件和日志级别 代理配置。）

安装Blackfire CLI工具

安装blackfire-agent包装：

sudo apt-get install blackfire-agent

运行配置命令初始化客户端

blackfire config

此命令会询问你的Blackfire 客户端凭据，登录或注册现在：

登录 或 注册

安装PHP探头

已知的不兼容

请注意编译在PHP 调试不支持，而且探头可与冲突了XDebug或 XHProf的 ; 使探头时禁用这些扩展。

Zend的线程安全（ZTS）

探头现已与兼容特稿版本的Linux上，但支持是目前实验。千万不能使用它在生产和请报告任何问题。

安装blackfire-PHP包：

sudo apt-get install blackfire-php

要完成探头安装，重新启动您的Web服务器或PHP-FPM，检查有没有错误消息。为了调试问题，您可以更改日志级别和日志文件探头配置。）

下一步是什么？

现在安装了一切，你可以开始使用Blackfire; 有没有必要改变你的代码，Blackfire在需要时自动插装只有它：