Laravel Facebook Ads 项目教程
1. 项目的目录结构及介绍
Laravel Facebook Ads 项目的目录结构遵循标准的 Laravel 项目结构,并包含了一些特定于 Facebook Ads API 的文件和目录。以下是主要目录和文件的介绍:
laravel-facebook-ads/
├── app/
│ ├── Http/
│ │ └── Controllers/
│ │ └── AdsController.php
├── config/
│ └── facebook-ads.php
├── resources/
│ └── views/
│ └── ads/
├── src/
│ └── LaravelFacebookAds/
│ ├── Providers/
│ │ └── LaravelFacebookServiceProvider.php
│ └── Clients/
│ └── Facebook.php
├── tests/
├── .env
├── composer.json
├── README.md
app/Http/Controllers/AdsController.php
: 控制器文件,用于处理与 Facebook Ads 相关的请求。config/facebook-ads.php
: 配置文件,包含 Facebook Ads API 的配置信息。resources/views/ads/
: 视图文件夹,包含显示广告的视图文件。src/LaravelFacebookAds/
: 项目的主要源代码目录,包含服务提供者和客户端类。tests/
: 测试文件夹,包含项目的测试文件。.env
: 环境文件,包含敏感信息的配置,如 Facebook Ads API 的密钥。composer.json
: Composer 依赖管理文件。README.md
: 项目说明文件。
2. 项目的启动文件介绍
项目的启动文件主要包括服务提供者文件和控制器文件。
服务提供者
src/LaravelFacebookAds/Providers/LaravelFacebookServiceProvider.php
是项目的服务提供者文件,负责注册和启动 Facebook Ads API 的相关服务。
namespace Edbizarro\LaravelFacebookAds\Providers;
use Illuminate\Support\ServiceProvider;
class LaravelFacebookServiceProvider extends ServiceProvider
{
public function boot()
{
$this->publishes([
__DIR__.'/../config/facebook-ads.php' => config_path('facebook-ads.php'),
]);
}
public function register()
{
$this->mergeConfigFrom(
__DIR__.'/../config/facebook-ads.php', 'facebook-ads'
);
}
}
控制器
app/Http/Controllers/AdsController.php
是项目的控制器文件,负责处理与 Facebook Ads 相关的请求。
namespace App\Http\Controllers;
use Edbizarro\LaravelFacebookAds\Clients\Facebook;
class AdsController extends Controller
{
protected $facebookClient;
public function __construct(Facebook $facebookClient)
{
$this->facebookClient = $facebookClient;
}
public function ads()
{
$accountId = 'act_12345678';
$ads = $this->facebookClient->account($accountId)->ads();
return view('ads', ['ads' => $ads]);
}
}
3. 项目的配置文件介绍
config/facebook-ads.php
是项目的配置文件,包含 Facebook Ads API 的配置信息。
return [
'app_id' => env('FB_ADS_APP_ID'),
'app_secret' => env('FB_ADS_APP_SECRET'),
];
该文件使用环境变量来存储敏感信息,如 Facebook Ads API 的应用 ID 和应用密钥。这些环境变量在 .env
文件中定义:
FB_ADS_APP_ID="YOUR_APP_ID"
FB_ADS_APP_SECRET="YOUR_APP_SECRET_KEY"
通过这种方式,可以确保敏感信息的安全性,并且便于在不同环境中进行配置。