PHPackages                             radig/locale - 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. radig/locale

AbandonedCakephp-plugin[Utility & Helpers](/categories/utility)

radig/locale
============

CakePHP Locale: allow your users to input localized data (like dates and decimals) while kept consistency at database-level.

2.0.8(11y ago)161.3k5MITPHPPHP >=5.3.0CI failing

Since Sep 10Pushed 11y ago9 watchersCompare

[ Source](https://github.com/radig/locale)[ Packagist](https://packagist.org/packages/radig/locale)[ Docs](https://github.com/radig/locale)[ RSS](/packages/radig-locale/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependencies (2)Versions (10)Used By (0)

CakePHP Locale [![Build Status](https://camo.githubusercontent.com/512506f16a174f461fa636189ac2f6d3360273bc804546dfe2df3ac4abba056c/68747470733a2f2f7472617669732d63692e6f72672f72616469672f6c6f63616c652e706e673f6272616e63683d6d6173746572 "Build Status")](https://travis-ci.org/radig/locale) [![Coverage Status](https://camo.githubusercontent.com/1d631af983ea3816bc5a0c1be803c207aa94161b1b458dc0e8dae196d509f96c/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f72616469672f6c6f63616c652f62616467652e737667 "Coverage Status")](https://coveralls.io/r/radig/locale)
=====================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#cakephp-locale--)

That plugin allow your users to input localized data (like dates and decimals) while
kept consistency at database-level.

It’s also included a Helper to output a non-localized data in users locale format.

Some static libs are delivered in bundle and are used by Helper and Behavior,
at the same time allow you to work with localized data where you need (like shell).
\--
Este plugin permite que usuários de seu sistema visualizem e insiram
dados em formatos locais/regionais ao mesmo tempo que garante a consistência
dos dados convertendo-o para um formato aceito pelo banco de dados escolhido.

Autor e Copyright
-----------------

[](#autor-e-copyright)

- **Copyright 2009-2014,** [**Radig – Soluções em TI**](http://www.radig.com.br)
- Licença MIT – Isto quer dizer que o código está disponível sem nenhuma garantia, ao mesmo tempo que
    você pode usa-lo de forma isolada ou em conjunto com seu próprio código.

Observações/Observations
------------------------

[](#observaçõesobservations)

- PHP >= 5.4
- CakePHP 2.x
- Consulte os testes incluído no plugin para ver melhor seu funcionamento (Consult unit tests included)

Como usar / How begin
---------------------

[](#como-usar--how-begin)

- A única configuração necessária é ter definido o locale da sua aplicação. Caso não tenha feito isso, basta utilizar a função *setlocale*
- Only configuration is define the locale of application with:

```
setlocale(LC_ALL, 'pt_BR.utf-8', 'pt_BR', 'pt-br', 'portuguese');
```

### Utilizando o Behavior

[](#utilizando-o-behavior)

- Basta definir, no model que deseja ativa-lo, a seguinte linha:

```
$actsAs = ['Locale.Locale'];
```

- A partir daí o behavior vai converter seus dados antes da validação e antes de salvar.

### Utilizando o Helper

[](#utilizando-o-helper)

- Nos controladores de interesse, adicione o helper *Locale.Locale*, deixando similar a linha abaixo:

```
$helpers = ['Locale.Locale'];
```

- Agora nas views de seu controlador, você pode chamar o helper, como abaixo:

```
echo $this->Locale->dateTime('2010-08-26');
```

### Além do Behavior e Helper…

[](#além-do-behavior-e-helper)

Agora você também pode trabalhar com a normalização de desnormalização de dados em diferentes contextos de sua aplicação (como em Shells), bastando para isso carregar as libs Localize e Unlocalize, de acordo com suas necessidades.

```
App::uses('Localize', 'Locale.Lib');
```

Elas são todas estáticas, então você deve usa-las sem se preocupar com instâncias:

```
$localizada = Localize::date('2012-04-16');
```

Desta forma, a variável *$localizada* armazenará *“16/04/2012”* caso seu locale esteja definido para pt\_BR

### Resolvendo problemas

[](#resolvendo-problemas)

#### ‘\[Notice\] Undefined index C: …’

[](#notice-undefined-index-c-)

Este erro ocorre quando o locale que você configurou no seu bootstrap não está disponível em seu SO. No caso do pt\_BR, ele não costuma vir habilitado no Ubuntu Server (e me parece que no Desktop também). Para resolver o problema você possuí pelo menos duas alternativas:

Em uma linha (pode funcionar em outras distros):

```
sudo locale-gen --no-purge --lang pt_BR
```

Deixando para o SO gerenciar:

1. `sudo vi /var/lib/locales/supported.d/local`
2. Acrescente o locale **pt\_BR.UTF-8 UTF-8**
3. `sudo dpkg-reconfigure locales`
4. Reinicie o Apache/PHP-FPM

#### ‘Notice (8): Undefined index: \[APP\\Plugin\\Locale\\Lib\\Localize.php, line 41\]’

[](#notice-8-undefined-index-apppluginlocaleliblocalizephp-line-41)

Outro erro relacionado ao locale do sistema que já foi reportado na \[issue #2\]:[\#2](https://github.com/radig/locale/issues/2)
e ocorre sempre na primeira execução do script (antes de haver cache de APC/Arquivo…).

A solução consiste em incluir o locale ‘portuguese’ quando configurar o setlocale.

```
setlocale(LC_ALL, 'pt_BR.utf-8', 'pt_BR', 'pt-br', 'portuguese');

```

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity25

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 90.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~73 days

Recently: every ~98 days

Total

9

Last Release

4045d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6b5400117f71ee0df6868fd300a96fceb0405ee8e959ea2df3116387d41c5a83?d=identicon)[CauanCabral](/maintainers/CauanCabral)

---

Top Contributors

[![CauanCabral](https://avatars.githubusercontent.com/u/83092?v=4)](https://github.com/CauanCabral "CauanCabral (129 commits)")[![agripinoduarte](https://avatars.githubusercontent.com/u/104159?v=4)](https://github.com/agripinoduarte "agripinoduarte (5 commits)")[![ssaeki](https://avatars.githubusercontent.com/u/385562?v=4)](https://github.com/ssaeki "ssaeki (5 commits)")[![viniciusbig](https://avatars.githubusercontent.com/u/191755?v=4)](https://github.com/viniciusbig "viniciusbig (2 commits)")[![michelmotta](https://avatars.githubusercontent.com/u/4741910?v=4)](https://github.com/michelmotta "michelmotta (1 commits)")

---

Tags

helpercakephpformatdatelocaleBehaviorradig

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/radig-locale/health.svg)

```
[![Health](https://phpackages.com/badges/radig-locale/health.svg)](https://phpackages.com/packages/radig-locale)
```

###  Alternatives

[kartik-v/yii2-datecontrol

Date control module allowing separation of formats for View and Model for Yii Framework 2.0

551.5M36](/packages/kartik-v-yii2-datecontrol)[dereuromark/cakephp-url-cache

CakePHP plugin to speed up URL reverse lookup

24117.2k](/packages/dereuromark-cakephp-url-cache)[torifat/cake-menu_builder

A dynamic menu building helper for CakePHP 2.x

755.6k](/packages/torifat-cake-menu-builder)[codaxis/cakephp-bootstrap3-helpers

CakePHP highly configurable helpers for Bootstrap 3 framework.

4111.5k2](/packages/codaxis-cakephp-bootstrap3-helpers)[dereuromark/cakephp-calendar

A CakePHP plugin to easily create calendars.

1646.8k1](/packages/dereuromark-cakephp-calendar)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)