README

简单易用的 XenForo 桥接器库。本软件包的目的是允许开发者轻松地将现有/新应用程序与 XenForo 论坛平台集成。本软件包仍在积极开发中，因此请谨慎使用。我还包含了一个 ServiceProvider，可在 Laravel 应用程序中使用。

如果您想看到我们正在使用的此软件包的实际效果，请访问 AstronomyConnect.com - ItemHub 数据库。这是一个 Laravel 5 应用程序，Xenforo 位于公共文件夹中。模板已在 Xenforo 中设计和实现，并由此桥接器渲染，而不是使用 Blade。

安装

使用 Composer 安装 XenforoBridge 软件包，请在您的 composer.json 文件中添加以下内容。

{
    "require": {
        "urb/xenforobridge": "dev-master"
    }
}

或者使用 composer require 命令

composer require urb/xenforobridge:dev-master

要将 XenforoBridge 安装到 Laravel 5，请将以下 ServiceProvider 添加到您的 'config/app.php' 文件中的 'providers' 数组中

'providers' => array(
		'Urb\XenforoBridge\XenforoBridgeServiceProvider::class',
)

然后使用以下命令发布配置文件

php artisan vendor:publish

这将添加文件 'config/xenforobridge.php'。这是您放置使用 XenForo Bridge 所需配置的地方。

在此配置文件中，您需要提供您的 XenForo 安装的全目录路径和基本 URL 路径，如下例所示

return array(
		'xenforo_directory_path' => '/var/www/html/public/forums',
		'xenforo_base_url_path'  => '//example.com/forums/', //Default '/'
	);

安装中间件

要安装中间件，您需要打开 app\Http\Kernel.php 并将以下中间件添加到全局中间件数组或路由中间件数组中。

以下是一个将中间件添加到路由中间件数组的示例

protected $routeMiddleware = [
		'xen.auth' => 'Urb\XenforoBridge\Middleware\XenAuthMiddleware',
		'xen.auth.admin' => 'Urb\XenforoBridge\Middleware\XenAuthAdminMiddleware',
	];

然后您可以在路由中使用它们，如下所示

Route::get('/example', ['middleware' => 'xen.auth',function(){
	//Do stuff
}]);

或者您可以直接在控制器中使用它们

class SampleController extends Controller {


    function __construct()
    {

        $this->middleware('xen.auth');
    }

}

有关中间件开发和安装的更多信息，请参阅 Laravel 文档 - 中间件

致谢

特别感谢 VinceG，我的想法和大部分工作基于他的软件包 xenforo-sdk，该软件包之前已集成到一个正在进行的项目中。