README

这是一个 Laravel (4.1 及以上版本) 的包，通过 artisan 命令从 Google 电子表格生成 Laravel 语言文件。

它将

• 从类似以下格式的电子表格读取数据 这个
• 输出为 Laravel Lang 文件，例如 这些

这个库用于简化与 Laravel 框架的接口。大部分实际工作是由关键依赖项完成的。

要求

• Laravel >4.1
• PHP >5.4
• Composer 依赖项
  • Google Spreadsheet Exporter - 这里包含大部分逻辑。所以关于电子表格格式和解析方式的文档大部分都可以在这里找到
  • Google 电子表格 API 客户端
  • 官方的 Google API 客户端
• 可读的 Google 电子表格
  • 电子表格必须是新格式（即 Google Sheets）才能兼容
  • 必须与客户端电子邮件共享（以下将详细说明如何生成一个）

背景

目标是

• 避免硬编码复制文本
• 减少对复制文本进行编辑时所需的开发周期
• 优雅地处理复制文本的多个翻译

更多背景信息可以在 Google Spreadsheet Exporter 下找到。特别是，请阅读如何设置 Google API 客户端凭证的相关内容。

待办事项

• 通过在 Laravel 应用中使用来完善代码库
• 文档
  • 如何设置 Google API 凭证
  • 用法
  • 贡献
• PhpUnit 测试

安装

主要通过 composer 进行安装。

在你的项目中创建一个 composer.json 文件，并添加以下内容

{
    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/asimlqt/php-google-spreadsheet-client"
        },
        {
            "type": "vcs",
            "url": "https://github.com/mechastorm/google-spreadsheet-exporter"
        }
    ],
    "require": {
        "mechastorm/laravel-lang-google-spreadsheet-importer": "1.*"
    }
}

1. 添加到服务提供者

安装完包后，你需要在 app/config/app.php 中的 providers 添加它。

示例

'providers' => array(
    'Mechastorm\LaravelLangGoogleSpreadsheetImporter\LaravelLangGoogleSpreadsheetImporterServiceProvider',
),

然后通过运行 php artisan list 来确认 artisan 命令是否存在，并检查输出中是否有 google-spreadsheet:generate-lang 命令。

2. 发布配置并配置

建议发布包的配置。

php artisan config:publish mechastorm/laravel-lang-google-spreadsheet-importer

你应该打开 app/config/packages/mechastorm/laravel-lang-google-spreadsheet-importer/config.php，并添加有关你的电子表格和 Google API 访问的详细信息。有关如何添加这些配置的详细信息，请参阅此主要 readme，特别是关于获取 Google API 凭证的说明。

强烈建议为每个环境进行单独的配置。

用法

假设你已经正确安装和配置了它，你可以直接运行 artisan 命令来生成语言文件

php artisan google-spreadsheet:generate-lang

或者通过环境变量

php artisan google-spreadsheet:generate-lang --env={env_name}

测试

即将推出！

贡献者

• Shih Oon Liong (@mechastorm)

许可证

在 Apache 2.0 许可证 下发布。