Sections

Abstract Class Phalcon\Translate\Adapter\AbstractAdapter

Source on GitHub

Namespace Phalcon\Translate\Adapter
Uses Phalcon\Helper\Arr, Phalcon\Translate\Exception, Phalcon\Translate\InterpolatorFactory
Implements AdapterInterface

Phalcon\Translate\Adapter

Base class for Phalcon\Translate adapters

Properties

/**
 * @var string
 */
protected defaultInterpolator = ;

/**
    * @var InterpolatorFactory
    */
protected interpolatorFactory;

Methods

public function __construct( InterpolatorFactory $interpolator, array $options );
public function _( string $translateKey, array $placeholders = [] ): string;

Returns the translation string of the given key (alias of method ‘t’)

public function offsetExists( mixed $translateKey ): bool;

Check whether a translation key exists

public function offsetGet( mixed $translateKey ): mixed;

Returns the translation related to the given key

public function offsetSet( mixed $offset, mixed $value ): void;

Sets a translation value

public function offsetUnset( mixed $offset ): void;

Unsets a translation from the dictionary

public function t( string $translateKey, array $placeholders = [] ): string;

Returns the translation string of the given key

protected function replacePlaceholders( string $translation, array $placeholders = [] ): string;

Replaces placeholders by the values passed

Interface Phalcon\Translate\Adapter\AdapterInterface

Source on GitHub

Namespace Phalcon\Translate\Adapter

Phalcon\Translate\Adapter\AdapterInterface

Interface for Phalcon\Translate adapters

Methods

public function exists( string $index ): bool;

Check whether is defined a translation key in the internal array

public function query( string $translateKey, array $placeholders = [] ): string;

Returns the translation related to the given key

public function t( string $translateKey, array $placeholders = [] ): string;

Returns the translation string of the given key

Class Phalcon\Translate\Adapter\Csv

Source on GitHub

Namespace Phalcon\Translate\Adapter
Uses ArrayAccess, Phalcon\Translate\Exception, Phalcon\Translate\InterpolatorFactory
Extends AbstractAdapter
Implements ArrayAccess

Phalcon\Translate\Adapter\Csv

Allows to define translation lists using CSV file

Properties

/**
 * @var array
 */
protected translate;

Methods

public function __construct( InterpolatorFactory $interpolator, array $options );

Phalcon\Translate\Adapter\Csv constructor

public function exists( string $index ): bool;

Check whether is defined a translation key in the internal array

public function query( string $index, array $placeholders = [] ): string;

Returns the translation related to the given key

Class Phalcon\Translate\Adapter\Gettext

Source on GitHub

Namespace Phalcon\Translate\Adapter
Uses ArrayAccess, Phalcon\Translate\Exception, Phalcon\Translate\InterpolatorFactory
Extends AbstractAdapter
Implements ArrayAccess

Phalcon\Translate\Adapter\Gettext

use Phalcon\Translate\Adapter\Gettext;

$adapter = new Gettext(
    [
        "locale"        => "de_DE.UTF-8",
        "defaultDomain" => "translations",
        "directory"     => "/path/to/application/locales",
        "category"      => LC_MESSAGES,
    ]
);

Allows translate using gettext

Properties

/**
 * @var int
 */
protected category;

/**
 * @var string
 */
protected defaultDomain;

/**
 * @var string|array
 */
protected directory;

/**
 * @var string
 */
protected locale;

Methods

public function __construct( InterpolatorFactory $interpolator, array $options );

Phalcon\Translate\Adapter\Gettext constructor

public function exists( string $index ): bool;

Check whether is defined a translation key in the internal array

public function getCategory(): int
public function getDefaultDomain(): string
public function getDirectory(): string|array
public function getLocale(): string
public function nquery( string $msgid1, string $msgid2, int $count, array $placeholders = [], string $domain = null ): string;

The plural version of gettext(). Some languages have more than one form for plural messages dependent on the count.

public function query( string $index, array $placeholders = [] ): string;

Returns the translation related to the given key.

$translator->query("你好 %name%!", ["name" => "Phalcon"]);
public function resetDomain(): string;

Sets the default domain

public function setDefaultDomain( string $domain ): void;

Sets the domain default to search within when calls are made to gettext()

public function setDirectory( mixed $directory ): void;

Sets the path for a domain

// Set the directory path
$gettext->setDirectory("/path/to/the/messages");

// Set the domains and directories path
$gettext->setDirectory(
    [
        "messages" => "/path/to/the/messages",
        "another"  => "/path/to/the/another",
    ]
);
public function setDomain( mixed $domain ): string;

Changes the current domain (i.e. the translation file)

public function setLocale( int $category, string $locale ): string | bool;

Sets locale information

// Set locale to Dutch
$gettext->setLocale(LC_ALL, "nl_NL");

// Try different possible locale names for German
$gettext->setLocale(LC_ALL, "[email protected]", "de_DE", "de", "ge");
protected function getOptionsDefault(): array;

Gets default options

protected function prepareOptions( array $options ): void;

Validator for constructor

Class Phalcon\Translate\Adapter\NativeArray

Source on GitHub

Namespace Phalcon\Translate\Adapter
Uses ArrayAccess, Phalcon\Translate\Exception, Phalcon\Translate\InterpolatorFactory
Extends AbstractAdapter
Implements ArrayAccess

Phalcon\Translate\Adapter\NativeArray

Allows to define translation lists using PHP arrays

Properties

/**
 * @var array
 */
private translate;

/**
 * @var bool
 */
private triggerError = false;

Methods

public function __construct( InterpolatorFactory $interpolator, array $options );

Phalcon\Translate\Adapter\NativeArray constructor

public function exists( string $index ): bool;

Check whether is defined a translation key in the internal array

public function notFound( string $index ): string;

Whenever a key is not found this method will be called

public function query( string $index, array $placeholders = [] ): string;

Returns the translation related to the given key

Class Phalcon\Translate\Exception

Source on GitHub

Namespace Phalcon\Translate
Extends \Phalcon\Exception

Phalcon\Translate\Exception

Class for exceptions thrown by Phalcon\Translate

Class Phalcon\Translate\Interpolator\AssociativeArray

Source on GitHub

Namespace Phalcon\Translate\Interpolator
Implements InterpolatorInterface

This file is part of the Phalcon Framework.

(c) Phalcon Team [email protected]

For the full copyright and license information, please view the LICENSE.txt file that was distributed with this source code.

Methods

public function replacePlaceholders( string $translation, array $placeholders = [] ): string;

Replaces placeholders by the values passed

Class Phalcon\Translate\Interpolator\IndexedArray

Source on GitHub

Namespace Phalcon\Translate\Interpolator
Implements InterpolatorInterface

This file is part of the Phalcon Framework.

(c) Phalcon Team [email protected]

For the full copyright and license information, please view the LICENSE.txt file that was distributed with this source code.

Methods

public function replacePlaceholders( string $translation, array $placeholders = [] ): string;

Replaces placeholders by the values passed

Interface Phalcon\Translate\Interpolator\InterpolatorInterface

Source on GitHub

Namespace Phalcon\Translate\Interpolator

Phalcon\Translate\InterpolatorInterface

Interface for Phalcon\Translate interpolators

Methods

public function replacePlaceholders( string $translation, array $placeholders = [] ): string;

Replaces placeholders by the values passed

Class Phalcon\Translate\InterpolatorFactory

Source on GitHub

Namespace Phalcon\Translate
Uses Phalcon\Factory\AbstractFactory, Phalcon\Translate\Interpolator\InterpolatorInterface
Extends AbstractFactory

This file is part of the Phalcon Framework.

(c) Phalcon Team [email protected]

For the full copyright and license information, please view the LICENSE.txt file that was distributed with this source code.

Methods

public function __construct( array $services = [] );

AdapterFactory constructor.

public function newInstance( string $name ): InterpolatorInterface;

Create a new instance of the adapter

protected function getAdapters(): array;

Class Phalcon\Translate\TranslateFactory

Source on GitHub

Namespace Phalcon\Translate
Uses Phalcon\Config, Phalcon\Factory\AbstractFactory, Phalcon\Helper\Arr, Phalcon\Translate\Adapter\AdapterInterface
Extends AbstractFactory

This file is part of the Phalcon Framework.

(c) Phalcon Team [email protected]

For the full copyright and license information, please view the LICENSE.txt file that was distributed with this source code.

Properties

/**
 * @var InterpolatorFactory
 */
private interpolator;

Methods

public function __construct( InterpolatorFactory $interpolator, array $services = [] );

AdapterFactory constructor.

public function load( mixed $config ): mixed;

Factory to create an instance from a Config object

public function newInstance( string $name, array $options = [] ): AdapterInterface;

Create a new instance of the adapter

protected function getAdapters(): array;