README

ramsey/str-begins-ends 提供函数来测试字符串是否以特定的子串开头或结尾。这是一个基于Will Hudgins的PHP RFC "添加str begin和end函数"的polyfill。

本项目遵循贡献者行为准则。通过参与本项目及其社区，你应遵守此准则。

安装

推荐的安装方法是使用Composer。运行以下命令安装包并将它作为项目composer.json的需求项添加：

composer require ramsey/str-begins-ends

文档

该库在全局作用域中提供了以下函数。它不会与任何使用它的项目发生冲突，如果PHP决定在未来版本中采用并实现RFC，则不会发生冲突。

str_starts_with

str_starts_with(string $haystack , string $needle): bool

执行一个大小写敏感的检查，以确定$haystack是否以$needle开头。

示例

$url = 'http://example.com';

if (str_starts_with($url, 'http://')) {
    $url = str_replace('http://', 'https://', $url);
}

str_ends_with

str_ends_with(string $haystack , string $needle): bool

执行一个大小写敏感的检查，以确定$haystack是否以$needle结尾。

示例

$file = '/path/to/something.log';

if (str_ends_with($file, '.log')) {
    $contents = file_get_contents($file);
}

str_begins_with_ci

str_begins_with_ci(string $haystack , string $needle): bool

执行一个大小写不敏感的检查，以确定$haystack是否以$needle开头。

示例

$url = 'HTTPS://example.com';

if (str_begins_with_ci($url, 'https://')) {
    $url = substr($url, 8);
}

str_ends_with_ci

str_ends_with_ci(string $haystack , string $needle): bool

执行一个大小写不敏感的检查，以确定$haystack是否以$needle结尾。

示例

$file = '/path/to/something.TXT';

if (str_ends_with_ci($file, '.txt')) {
    $contents = file_get_contents($file);
}

mb_str_starts_with

mb_str_starts_with(string $haystack , string $needle [, string $encoding = mb_internal_encoding()]): bool

执行一个大小写敏感、多字节安全的str_starts_with()操作来检查$haystack是否以$needle开头。

此函数仅在安装了mbstring扩展的情况下可用。

示例

$runePoem = 'ᚠᛇᚻ᛫ᛒᛦᚦ᛫ᚠᚱᚩᚠᚢᚱ᛫ᚠᛁᚱᚪ᛫ᚷᛖᚻᚹᛦᛚᚳᚢᛗ';

if (mb_str_starts_with($runePoem, 'ᚠᛇᚻ')) {
    $poem = 'Wealth is a comfort to all men';
}

mb_str_ends_with

mb_str_ends_with(string $haystack , string $needle [, string $encoding = mb_internal_encoding()]): bool

执行一个大小写敏感、多字节安全的str_ends_with()操作来检查$haystack是否以$needle结尾。

此函数仅在安装了mbstring扩展的情况下可用。

示例

$sanskrit = 'काचं शक्नोम्यत्तुम् । नोपहिनस्ति माम् ॥';

if (mb_str_ends_with($sanskrit, 'माम् ॥')) {
    $translation = 'I can eat glass';
}

mb_str_begins_with_ci

mb_str_begins_with_ci(string $haystack , string $needle [, string $encoding = mb_internal_encoding()]): bool

执行一个不区分大小写的多字节安全的 str_begins_with_ci() 操作，用于检查 $haystack 是否以 $needle 开头。

此函数仅在安装了mbstring扩展的情况下可用。

示例

$poem = 'Τὴ γλῶσσα μοῦ ἔδωσαν ἑλληνικὴ';

if (mb_str_begins_with_ci($poem, 'ΤῊ')) {
    $poet = 'Οδυσσέας Ελύτης';
}

mb_str_ends_with_ci

mb_str_ends_with_ci(string $haystack , string $needle [, string $encoding = mb_internal_encoding()]): bool

执行一个不区分大小写的多字节安全的 str_ends_with_ci() 操作，用于检查 $haystack 是否以 $needle 结尾。

此函数仅在安装了mbstring扩展的情况下可用。

示例

$poem = 'Τὴ γλῶσσα μοῦ ἔδωσαν ἑλληνικὴ';

if (mb_str_ends_with_ci($poem, 'ἙΛΛΗΝΙΚῊ')) {
    $poet = 'Οδυσσέας Ελύτης';
}

贡献

欢迎贡献！请阅读 CONTRIBUTING 了解详情。

版权与许可

ramsey/str-begins-ends 库版权 © Ben Ramsey，使用许可遵循 MIT 许可协议（MIT）。请参阅 LICENSE 了解更多信息。