alphasnow/opencc-php

OpenCC made with PHP

v3.3.3 2021-03-30 07:00 UTC

Requires

• php: >=7.0
• neutron/temporary-filesystem: ^3.0
• symfony/process: ^2.7 || ^3.0 || ^4.0 || ^5.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^2.16
• mockery/mockery: ~1.0
• orchestra/testbench: 3.5.*
• phpstan/phpstan: ^0.12.82
• phpunit/phpunit: ~6.0

MIT

• alphasnow

• php
• laravel
• OpenCC

README

介绍

中文简繁转换开源项目，支持词汇级别的转换、异体字转换和地区习惯用词转换（中国大陆、臺湾、香港）。

安装

1. 第一步,在服务器安装opencc

   • Ubuntu apt install opencc
   • CentOS yum install opencc opencc-tools
   • Window x32 下载
   • Window x64 下载

   https://github.com/BYVoid/OpenCC/wiki/Download

2. 第二步,使用Composer安装opencc-php

   composer require alphasnow/opencc-php

应用配置

Laravel应用

1. (Laravel5.5+ 忽略)在 config/app.php 注册 ServiceProvider 和 Facade

   [
       'providers' => [
           // ...
           AlphaSnow\OpenCC\ServiceProvider::class,
       ],
       'aliases' => [
           // ...
           'OpenCC' => AlphaSnow\OpenCC\Facade::class,
       ]
   ];

2. 发布配置文件

   php artisan vendor:publish --provider="AlphaSnow\OpenCC\ServiceProvider"

3. 修改配置文件 config/opencc.php

   return [
       // 执行文件的路径,默认:/usr/bin/opencc
       'binary_path'=> env('OPENCC_BINARY', '/usr/bin/opencc'),
       // 预设配置文件夹的路径,默认:/usr/share/opencc
       'config_path'=> env('OPENCC_CONFIG', '/usr/share/opencc'),
   ];

   或修改环境配置 .env

   OPENCC_BINARY=/usr/bin/opencc
   OPENCC_CONFIG=/usr/share/opencc
   

快速使用

Laravel应用

// laravel应用可用外观
// 参数1:待转换内容, 参数2:预设配置(可省略.json)
$simplified = \OpenCC::convert('天氣乍涼人寂寞，光陰須得酒消磨。且來花裏聽笙歌。','t2s.json');
print_r($simplified);
// 天气乍凉人寂寞，光阴须得酒消磨。且来花里听笙歌。

$traditional = \OpenCC::convert('四面垂杨十里荷。问云何处最花多。画楼南畔夕阳和。', 's2t');
print_r($traditional);
// 四面垂楊十里荷。問云何處最花多。畫樓南畔夕陽和。

其他应用

use AlphaSnow\OpenCC\Command;
use AlphaSnow\OpenCC\OpenCC;

$command = new Command('/usr/bin/opencc','/usr/share/opencc');
$openCC = new OpenCC($command);

$result = $openCC->convert('天氣乍涼人寂寞，光陰須得酒消磨。且來花裏聽笙歌。','t2s.json');
print_r($result);
// 天气乍凉人寂寞，光阴须得酒消磨。且来花里听笙歌。

预设配置

• s2t.json Simplified Chinese to Traditional Chinese 简体到繁体
• t2s.json Traditional Chinese to Simplified Chinese 繁体到简体

备注说明

• 如需PHP原生扩展, 可使用 opencc4php.
• Window系统opencc配置示例

  OPENCC_BINARY=D:/OpenCC/build/bin/opencc.exe
  OPENCC_BINARY=D:/OpenCC/build/share/opencc
  

License

See LICENSE.