cse/helpers-word

此助手允许您修改字符串数据。包括倾斜、转写、转换月份日期以及将数字或金额转换为文字等,所有这些功能都可在该库中找到。

1.0.6 2019-04-28 08:58 UTC

This package is auto-updated.

Last update: 2024-08-29 05:00:15 UTC


README

英语 | 俄语

WORD CSE HELPERS

Travis (.org) Codecov Scrutinizer code quality

Packagist Minimum PHP Version Packagist GitHub repo size

此助手允许您修改字符串数据。包括倾斜、转写、转换月份日期以及将数字或金额转换为文字等,所有这些功能都可在该库中找到。

项目仓库: https://github.com/cs-eliseev/helpers-word

演示

$number = 21;
Word::getInclinationByNumber(
    $number,
    ['котик', 'котика', 'котиков'],
    'мурлычит ' . Word::convertUnsignedIntNumberToWord($number) . ' '
);
// мурлычит двадцать один котик

简介

CSE HELPERS 是一个包含几个库的集合,这些库是用 PHP 编写的简单函数,为人们提供。

尽管 PHP 是互联网的主要编程语言,但其功能不足。WORD CSE HELPERS 解决了这个问题:单词倾斜、单词转写、数字或总额转换为文字等。

CSE HELPERS 是为快速开发 Web 应用程序而创建的。

CSE Helper 项目

以下是一些关于如何初始化库和执行常见命令的信息。

安装

您可以在 这里 找到该项目的最新版本。

Composer

执行以下命令以获取软件包的最新版本

composer require cse/helpers-word

或者 composer.json 文件应包含以下内容

{
    "require": {
        "cse/helpers-word": "*"
    }
}

Git

在本地上克隆此存储库

git clone https://github.com/cs-eliseev/helpers-word.git

下载

在此处下载最新版本.

用法

该类包含静态方法,方便在任何项目中使用。请参阅示例 examples-word.php

将字符串转换为 UTF-8

示例默认字符集(CP1251)

$text = mb_convert_encoding('привет', 'CP1251');
Word::stringToUtf($text);
// привет

设置字符集

$text = mb_convert_encoding('привет', 'KOI8-R');
Word::stringToUtf($text, 'KOI8-R');
// привет

日期月份转换为文字转换器

示例

Word::convertDateMonthToWord('2019-01-01');
// 01 января 2019

将分隔符添加到结果中

Word::convertDateMonthToWord('05.05.2018', '/');
// 05/мая/2018

倾斜

示例

Word::getInclinationByNumber(10, ['котик', 'котика', 'котиков']);
// котиков

添加数字

Word::getInclinationByNumber(0, ['%d котик', '%d котика', '%d котиков']);
// 0 котиков

将字符串数字添加到文本中

Word::getInclinationByNumber('01', ['был %d котик', 'было %d котика', 'было %d котиков']);
// был 1 котик

添加文本前缀

   Word::getInclinationByNumber(4, ['котик', 'котика', 'котиков'], 'еще %d ');
// еще 4 котика

文本转写

示例

Word::transliterate('12 пользователей online');
// 12 polzovateley online

将数字转换为文字

示例

Word::convertUnsignedIntNumberToWord(0);
// ноль
Word::convertUnsignedIntNumberToWord('1001');
// одна тысяча один

改变单数倾斜

Word::convertUnsignedIntNumberToWord(2002, 0);
// две тысячи двe

将金额转换为文字

示例

Word::convertAmountToWord(0);
// ноль рублей 0 копеек

便士示例

Word::convertAmountToWord('1001.1');
// одна тысяча один рубль 10 копеек
Word::convertAmountToWord(2012.01);
// две тысячи двенадцать рублей 01 копейка

便士转换为文字示例

Word::convertAmountToWord(87654.02, true, true);
// восемьдесят семь тысяч шестьсот пятьдесят четыре рубля две копейки

忽略零便士

Word::convertAmountToWord('1098765.00', false);
// один миллион девяносто восемь тысяч семьсот шестьдесят пять рублей

驼峰式转换器

示例

Word::camelCase('example-word');
// ExampleWord

反转 CamelCase

Word::camelCase('ExampleWord', true);
// example-word

更改分隔符

Word::camelCase('ExampleWord', true, '/');
// example/word

测试 & 代码覆盖率

PHPUnit 用于单元测试。单元测试确保类和方法确实做了它应该做的事情。

有关 PHPUnit 的通用文档,请参阅 https://phpunit.de/documentation.html

要运行 PHPUnit 单元测试,请执行

phpunit PATH/TO/PROJECT/tests/

如果您需要代码覆盖率报告,请使用以下

phpunit --coverage-html ./report PATH/TO/PROJECT/tests/

使用 PHPUnit 默认配置

phpunit --configuration PATH/TO/PROJECT/phpunit.xml

捐赠

您可以通过 这里 支持此项目。您也可以通过为项目做出贡献、报告错误或提出功能建议来帮助。任何帮助都将非常受欢迎。

许可证

“CSE HELPERS”是一个开源的PHP库,采用MIT许可。请参阅许可文件获取更多信息。

GitHub @cs-eliseev