PHP Conference Nagoya 2025

    The ResourceBundle class

    (PHP 5 >= 5.3.2, PHP 7, PHP 8, PECL intl >= 2.0.0)

    简介

    Localized software products often require sets of data that are to be customized depending on current locale, e.g.: messages, labels, formatting patterns. ICU resource mechanism allows to define sets of resources that the application can load on locale basis, while accessing them in unified locale-independent fashion.

    This class implements access to ICU resource data files. These files are binary data arrays which ICU uses to store the localized data.

    ICU resource bundle can hold simple resources and complex resources. Complex resources are containers which can be either integer-indexed or string-indexed (just like PHP arrays). Simple resources can be of the following types: string, integer, binary data field or integer array.

    ResourceBundle supports direct access to the data through array access pattern and iteration via foreach, as well as access via class methods. The result will be PHP value for simple resources and ResourceBundle object for complex ones. All resources are read-only.

    类摘要

    class ResourceBundle implements IteratorAggregate, Countable {
    /* 方法 */
    public __construct(?string $locale, ?string $bundle, bool $fallback = true)
    public count(): int
    public static create(?string $locale, ?string $bundle, bool $fallback = true): ?ResourceBundle
    public get(string|int $index, bool $fallback = true): mixed
    public getErrorCode(): int
    public getErrorMessage(): string
    public static getLocales(string $bundle): array|false
    }

    更新日志

    版本 说明
    8.0.0 ResourceBundle implements IteratorAggregate now. Previously, Traversable was implemented instead.
    7.4.0 ResourceBundle implements Countable now.

    目录

    发现了问题？

    了解如何改进此页面 • 提交拉取请求 • 报告一个错误
    ＋添加备注

    用户贡献的备注 1 note

    up
    2
    maiseralves at gmail dot com
    13 years ago
    <?php
    /*
    * Struct of a Resource Bundle file
    * file root.txt
    * root:table {
    * usage:string { "Usage: genrb [Options] files" }
    * version:int { 122 }
    * errorcodes:array {
    * :string { "Invalid argument" }
    * :string { "File not found" }
    * }
    * }
    * use: $genrb root.txt to generate resource bundle file (root.res)
    */

    //recursive function to list a resource bundle file structure using a ResourceBundle Object ( ) reference
    function t($rb) {
    foreach(    $rb as $k => $v) {
    if(    is_object($v)) {
    print_r($v);
    var_dump($k);
    t($v);
    } else {
    var_dump($k . " " . $v);
    }
    }
    }
    //open root.res from folder locale
    $rb = new ResourceBundle('root', "./locale");

    t($rb);//call the function

    /* The output from root table is
    * |- string(34) "usage Usage: genrb [Options] files"
    * |- string(11) "version 122"
    * |- ResourceBundle Object ( ) string(10) "errorcodes"
    * |- string(18) "0 Invalid argument"
    * |- string(16) "1 File not found"
    */
    ?>
    ＋添加备注
    To Top