README

使用Guzzle作为核心的Google日历客户端。

功能

身份验证

• OAuth2 URL创建助手
• OAuth2身份验证捕获助手
• 通过插件对通过Guzzle客户端发送的请求进行签名
  • 如果OAuth2设置指定了离线模式，过期的访问令牌可以自动刷新

日历列表

• 列出可供认证用户使用的日历
• 从列表中删除日历

日历

• 创建新的账户子日历
• 查看/更新现有日历的元数据
• 删除账户子日历

事件

• 创建新事件
  • 包括重复事件
  • 添加参与者/邀请
• 查看/更新事件的元数据
• 删除单个或重复事件

空闲/忙碌查询

• 允许您查询日历上标记为忙碌的时间

自定义请求

• 如果您不想使用Guzzlecal提供的响应表示，我们提供了一个passthru选项，这将仅提供一个OAuth2认证的Guzzle客户端，您可以在上面做任何您想做的事情。如果您使用离线模式，过期的令牌也将自动刷新。

安装

通过Composer安装

根据您要使用的Guzzlecal版本，您的设置会有所不同。目标是保持此包最稳定的版本在master分支中，而develop分支包含最新更改。当您想要锁定到特定版本（您应该锁定任何重要内容）时，您将想要在composer.json中使用一个require行，可能看起来像"ekotechnology/guzzlecal": "0.2"等。如果您想跟进最新进展（不推荐用于任何重要内容），您可以将"ekotechnology/guzzlecal": "dev-develop"作为您的要求。

如果您不想手动修改composer.json，您可以在使用composer命令添加要求时搜索Guzzlecal。

通过Git/文件系统安装

如果您打算使用此方法，建议您收藏此存储库，以便您可以在最短时间内集成任何安全补丁或错误修复。

与Laravel 4一起使用

此包是在Laravel 4中构建和使用的，尽管目标是使其在其他PHP项目中也能正常工作。有关更多信息，请参阅下面的部分。

配置

Guzzlecal附带一个服务提供程序和外观，以便它可以与Laravel 4很好地结合。安装Guzzlecal后，对Laravel进行配置相当简单。您只需添加一个服务提供程序和外观的条目。

从您的应用程序的基本目录开始，您需要转到app配置文件，该文件位于app/config/app.php。您需要在providers数组中添加一个具有Ekotechnology\Guzzlecal\GuzzlecalServiceProvider值的条目。这可能会使您的providers数组看起来像这样

'providers' => array(
	'Illuminate\Foundation\Providers\ArtisanServiceProvider',
	'Illuminate\Auth\AuthServiceProvider',
	'Illuminate\Cache\CacheServiceProvider',
	'Illuminate\Foundation\Providers\CommandCreatorServiceProvider',
	'Illuminate\Foundation\Providers\ComposerServiceProvider',
	...
	'Illuminate\Validation\ValidationServiceProvider',
	'Illuminate\View\ViewServiceProvider',
	'Illuminate\Workbench\WorkbenchServiceProvider',
	'Ekotechnology\Guzzlecal\GuzzlecalServiceProvider'

),

现在，我们只需要注册 Facade 的别名。所以，在 aliases 数组中，你需要添加一个值为 Ekotechnology\Guzzlecal\Facades\GuzzlecalFacade 的条目。这可能会使你的 aliases 数组看起来像这样

'aliases' => array(
	'App'             => 'Illuminate\Support\Facades\App',
	'Artisan'         => 'Illuminate\Support\Facades\Artisan',
	'Auth'            => 'Illuminate\Support\Facades\Auth',
	'Blade'           => 'Illuminate\Support\Facades\Blade',
	'Cache'           => 'Illuminate\Support\Facades\Cache',
	'ClassLoader'     => 'Illuminate\Foundation\ClassLoader',
	'Config'          => 'Illuminate\Support\Facades\Config',
	...
	'Route'           => 'Illuminate\Support\Facades\Route',
	'Schema'          => 'Illuminate\Support\Facades\Schema',
	'Session'         => 'Illuminate\Support\Facades\Session',
	'URL'             => 'Illuminate\Support\Facades\URL',
	'Validator'       => 'Illuminate\Support\Facades\Validator',
	'View'            => 'Illuminate\Support\Facades\View',
	'Guzzlecal'       => 'Ekotechnology\Guzzlecal\Facades\GuzzlecalFacade'
),

示例

在 Laravel 4 之外使用

如果你没有使用 Laravel 4，仍然可以使用 Guzzlecal。你需要确保你已经自动加载了 Composer 自动加载器，如果你没有使用 Composer（你真的应该使用！），那么你只需确保 src/Ekotechnology/Guzzlecal 中的类被加载。