在 Laravel 4 上使用非 laravel 包

Question

是否可以在框架中包含不是专门为 L4 设计的包？ 如果是这样，它是如何完成的？我知道我需要将包添加到我的composer.json 中，这会将它添加到vendor 文件夹中，但是我可以在providers 数组中以某种方式注册它吗？还有其他必要的步骤吗？

我想使用最初为 Yii 设计的Google checkout package

Answer 1

在 Laravel 4 中使用第三方作曲家包

当开发者创建 composer 包时，他们应该使用 PSR-0 或 PSR-4 标准映射自动加载。如果不是这种情况，在你的 Laravel 应用程序中加载包可能会出现问题。 PSR-0 标准是：

{
    "autoload": {
        "psr-0": { "Acme": "src/" }
    }
}

还有 PSR-4 标准：

{
    "autoload": {
         "psr-4": { "Acme\\": "src/" }
    }
}

基本上，以上是告诉作曲家在哪里寻找名称空间文件的标准。如果您不使用自己的命名空间，则无需配置任何其他内容。

场景 1

在 Laravel 中遵循 PSR-0 标准的包（带有自动加载类映射）

这是一个简单的，例如我将使用 facebook php sdk，可以找到：

https://packagist.org/packages/facebook/php-sdk

第 1 步：

将包包含在您的 composer.json 文件中。

"require": {
    "laravel/framework": "4.0.*",
    "facebook/php-sdk": "dev-master"
}

第 2 步：

run: composer update

第 3 步：

因为 facebook 包使用了一个开箱即用的类映射，您可以立即开始使用该包。 （下面的代码示例直接来自普通视图。请在生产应用程序的视图中保留您的逻辑。）

$facebook = new Facebook(array(
    'appId'  => 'secret',
    'secret' => 'secret'
));
var_dump($facebook); // It works!

场景 2

对于这个例子，我将使用来自 instagram php api 的包装器。这里需要进行一些调整才能加载包。试一试吧！ 包可以在这里找到：

https://packagist.org/packages/fishmarket/instaphp

第 1 步：

添加到作曲家.json

"require": {
    "laravel/framework": "4.0.*",
    "fishmarket/instaphp": "dev-master"
}

然后就可以正常更新了（composer update）

接下来尝试像使用 facebook 包一样使用该包。同样，这只是视图中的代码。

$instagramconfig = array(
    'client_id' => 'secret',
    'client_secret'=> 'secret',
    'access_token' => 'secret'
);

$api = Instaphp::Instance(null, $instagramconfig);                
var_dump($api); // Epic fail!

如果你尝试上面的例子，你会得到这个错误：

FatalErrorException: Error: Class 'Instaphp' not found in ...

所以我们需要解决这个问题。为此，我们可以检查 instagram composer.json，它的自动加载与 facebook php sdk 不同。

"autoload": {
         "psr-0": { "Instaphp": "." }
    }

与 facebook composer.json 相比：

"autoload": {
        "classmap": ["src"]
    }

（Composer 处理不同类型的自动加载，从文件和类映射到 PSR。看看你的 vendor/composer/ 文件夹，看看它是如何完成的。）

现在我们必须手动加载类。很简单，只需添加这个（控制器、模型或视图的顶部）：

use Instaphp\Instaphp;

composer dump-autoload，它可以工作了！

第 2 步（可选）

另一种方法是（如果您不想使用“use”语句，您可以简单地告诉作曲家直接从您的代码中查找文件。只需像这样更改实例：

// reference the name-spaced class straight in the code
$api = Instaphp\Instaphp::Instance(null, $instagramconfig); 
var_dump($api); // It works

但是我建议使用usestatement 让其他开发人员（以及您未来的自己）清楚地了解程序中使用了哪些（外部）类/包。

场景 3

这里我们使用 Laravel 内置的 IOC 容器来注册服务提供者。请注意，某些软件包可能不适合此方法。我将使用与场景 2 中相同的 Instagram 包。

又快又脏

如果您不关心设计模式和服务提供者，您可以像这样绑定一个类：

App::bind('Instaphp', function($app)
{
    return new Instaphp\Instaphp;
});

然后你就这样解决了。

App::make('Instaphp');

快速而肮脏的结局

如果您正在处理一个更大的项目，并且您使用接口，您可能应该进一步抽象绑定。

第 1 步：

在您的应用文件夹内创建一个文件夹，例如“providers”文件夹。

app/providers

确保 Laravel 自动加载该文件夹，您可以将一些附加信息传递给 composer.json，如下所示：

"autoload": {

    "classmap": [
        "app/commands",
        "app/controllers",
        "app/models",
        "app/database/migrations",
        "app/database/seeds",
        "app/tests/TestCase.php",
        "app/providers" // this was added
    ]

},

现在在名为 Instagram.php 的新文件夹中创建一个文件并将其放入：

 <?php

    use Illuminate\Support\ServiceProvider;

    class InstagramServiceProvider extends ServiceProvider {

    public function register()
    {
        $this->app->bind('Instaphp', function()
        {
            return new Instaphp\Instaphp;
        });

    }

}

现在再次运行composer dump-autoload，就可以使用这个包了。请注意，instagram 包有一个final private function __construct()，这意味着您不能在不将构造方法更改为公共的情况下在原始类之外使用该包。我并不是说这是一个好习惯，我建议在使用 instagram 包的情况下使用场景 2。

无论如何，在这之后你可以像这样使用这个包：

$instagramInstance = App::make('Instaphp');

$instagramconfig = array(
    'client_id' => 'secret',
    'client_secret'=> 'secret',
    'access_token' => 'secret'
 );

$instagram = new $instagramInstance();
$userfeed = $instagram->Users->feed($instagramconfig);

var_dump($userfeed); // It works!

Answer 2

将"tvr/googlecheckout": "dev-master" 添加到您的composer.json。

运行composer install，就可以使用IoC容器了。一些代码示例可以在 Laravel 4 的官方文档中找到：http://four.laravel.com/docs/ioc#basic-usage