PHPackages                             loveyu/php-opencc - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. loveyu/php-opencc

ActiveLibrary[Utility & Helpers](/categories/utility)

loveyu/php-opencc
=================

中文简繁转换，支持词汇级别的转换、异体字转换和地区习惯用词转换（中国大陆、台湾、香港、日本新字体）。基于 \[BYVoid/OpenCC\](https://github.com/BYVoid/OpenCC) 数据实现。

1.2.3(5mo ago)112MITPHPPHP >=8.0CI passing

Since Nov 28Pushed 5mo agoCompare

[ Source](https://github.com/loveyu/php-opencc)[ Packagist](https://packagist.org/packages/loveyu/php-opencc)[ GitHub Sponsors](https://github.com/overtrue)[ RSS](/packages/loveyu-php-opencc/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (9)Versions (3)Used By (0)

PHP OpenCC
==========

[](#php-opencc)

中文简繁转换，支持词汇级别的转换、异体字转换和地区习惯用词转换（中国大陆、台湾、香港、日本新字体）。基于 [BYVoid/OpenCC](https://github.com/BYVoid/OpenCC) 数据实现。

[![Build Status](https://github.com/loveyu/php-opencc/actions/workflows/test.yml/badge.svg)](https://github.com/loveyu/php-opencc/actions/workflows/test.yml)[![Latest Stable Version](https://camo.githubusercontent.com/7481619b75817ca688b35de901e970210a0dd567c418d4e77a1560291a650fd9/68747470733a2f2f706f7365722e707567782e6f72672f6c6f766579752f7068702d6f70656e63632f762f737461626c65)](https://packagist.org/packages/loveyu/php-opencc)[![Total Downloads](https://camo.githubusercontent.com/8fc8847da5c864524c9c551bc9627980d60ff911d253aa095e417afb9cf661df/68747470733a2f2f706f7365722e707567782e6f72672f6c6f766579752f7068702d6f70656e63632f646f776e6c6f616473)](https://packagist.org/packages/loveyu/php-opencc)[![License](https://camo.githubusercontent.com/939b58413c7146149833c46e64accbd07d269302c879ad8c899de58f40737706/68747470733a2f2f706f7365722e707567782e6f72672f6c6f766579752f7068702d6f70656e63632f6c6963656e7365)](https://packagist.org/packages/loveyu/php-opencc)

安装
--

[](#安装)

```
composer require loveyu/php-opencc -vvv
```

使用
--

[](#使用)

```
use Overtrue\PHPOpenCC\OpenCC;

echo OpenCC::convert('服务器', 'SIMPLIFIED_TO_TAIWAN_WITH_PHRASE');
// output: 伺服器

// 批量转换
OpenCC::convert(['程序员', '服务器'], 'SIMPLIFIED_TO_TAIWAN_WITH_PHRASE');
// output: ['程式設計師', '伺服器']
```

### 使用策略别名

[](#使用策略别名)

```
use Overtrue\PHPOpenCC\OpenCC;
use Overtrue\PHPOpenCC\Strategy;

// 以下方法等价：

// 方法
echo OpenCC::s2tw('服务器');
echo OpenCC::simplifiedToTaiwan('服务器');

// 字符串
echo OpenCC::convert('服务器', 's2tw');
echo OpenCC::convert('服务器', 'S2TW');
echo OpenCC::convert('服务器', 'SIMPLIFIED_TO_TAIWAN');

// 常量
echo OpenCC::convert('服务器', Strategy::S2TW);
echo OpenCC::convert('服务器', Strategy::SIMPLIFIED_TO_TAIWAN);
```

### 流式/文件转换（可选）

[](#流式文件转换可选)

```
use Overtrue\PHPOpenCC\StreamConverter;

// 流到流
touch('out.txt');
$in = fopen('input.txt', 'rb');
$out = fopen('out.txt', 'wb');
StreamConverter::convertStream($in, $out, 'S2T');

// 文件到文件
StreamConverter::convertFile('input.txt', 'out.txt', 'S2TWP');
```

> 注意：按行转换不适用于跨行的词组替换场景。

### 转换策略

[](#转换策略)

策略 （别名）说明`SIMPLIFIED_TO_TRADITIONAL(S2T)`简体到繁体`SIMPLIFIED_TO_HONGKONG(S2HK)`简体到香港繁体`SIMPLIFIED_TO_JAPANESE(S2JP)`简体到日文`SIMPLIFIED_TO_TAIWAN(S2TW)`简体到台湾正体`SIMPLIFIED_TO_TAIWAN_WITH_PHRASE(2TWP)`简体到台湾正体, 带词汇本地化`HONGKONG_TO_TRADITIONAL(HK2T)`香港繁体到正体`HONGKONG_TO_SIMPLIFIED(HK2S)`香港繁体到简体`TAIWAN_TO_SIMPLIFIED(TW2S)`台湾正体到简体`TAIWAN_TO_TRADITIONAL(TW2T)`台湾正体到繁体`TAIWAN_TO_SIMPLIFIED_WITH_PHRASE(TW2SP)`台湾正体到简体, 带词汇本地化`TRADITIONAL_TO_HONGKONG(T2HK)`正体到香港繁体`TRADITIONAL_TO_SIMPLIFIED(T2S)`繁体到简体`TRADITIONAL_TO_TAIWAN(T2TW)`繁体到台湾正体`TRADITIONAL_TO_JAPANESE(T2JP)`繁体到日文`JAPANESE_TO_TRADITIONAL(JP2T)`日文到繁体`JAPANESE_TO_SIMPLIFIED(JP2S)`日文到简体### 在命令行使用

[](#在命令行使用)

```
php vendor/bin/opencc "汉字" s2tw
```

说明：

```
$ php vendor/bin/opencc --help
Description:
  中文简繁转换，支持词汇级别的转换、异体字转换和地区习惯用词转换（中国大陆、台湾、香港、日本新字体）。

Usage:
  convert  []

Arguments:
  string                待转换的字符串
  strategy              转换策略 [default: "SIMPLIFIED_TO_TRADITIONAL"]
```

### 性能与部署建议

[](#性能与部署建议)

- 强烈建议在生产环境开启并配置 Opcache，并将常用字典文件加入 `opcache.preload`，可显著降低首次调用延迟。
    - 典型 php.ini 片段（示例）： ```
        opcache.enable=1
        opcache.enable_cli=1
        opcache.preload=/path/to/preload.php
        ```
    - `preload.php` 示例： ```