How to clear php's gettext cache without restart Apache nor change domain?

Question

This is a little code snippet from php manual:

putenv('LC_ALL=zh_CN');
setlocale(LC_ALL, 'zh_CN');

bindtextdomain('domain', './locale');
textdomain('domain');

echo gettext('Hello');

Which will output 你好 as defined in domain.mo file, but the problem is as long as the Apache is running, gettext() always return the cached result.

If I change the translation of Hello to 您好 in domain.mo, it will still output 你好.

However there is a fix for this by changing the domain argument of bindtextdomain() and textdomain() to a new name. Like from "domain" to "domain2". But this is really painful to edit the php file every time I updated the .mo file.

Is there a better way for doing this, like remove some folders or calling some php functions to do the job? So that I can write a little script for this purpose.

score 17 · Accepted Answer · edited May 23 '17 at 12:25

17

Every solution (1, 2, 3) suggests changing the domain to get rid of the cache problem, but this will create lots of out-of-date cache in memory.

So I dug into the gnu-gettext source for details on the cache strategy (bindtextdom.c:78.)

When bindtextdomain(domain, dirname) is called, it will check whether domain exists in the cache; if so, it will then check if dirname is the same with the one in the cache. If this fails, it will force a cache flush for the same domain, instead of creating a new one in memory.

The fix is incredibly simple, first create a dummy link to the locale folder where your .mo file is stored:

cd locale
ln -s . nocache

Then add one single line before bindtextdomain()

bindtextdomain('domain', './locale/nocache');
bindtextdomain('domain', './locale');

Now the cache is forced to flush every time.

Updates:

This hack may not works in some cases (Can't figure out the exact conditions.) This solution is NOT something you should use in production environment, but only for those who need to fix something while keeping httpd running!

Whenever you can, please avoid using gettext from very beginning, this is really something ancient and should be deprecated for good.

edited May 23 '17 at 12:25

Community

1
1

answered Nov 29 '12 at 15:25

xiaoyi

6,641
1
34
51

And dont' forget to add some if (debug) { ... nocache} to minimize stats load on disk. – gaRex Jan 09 '13 at 03:04
22

"Whenever you can, please avoid using gettext from very beginning, this is really something ancient and should be deprecated for good." Why should I avoid it? And could you name some alternatives? – Stan Oct 10 '13 at 15:14
@Stan check out the answer below – xiaoyi Oct 10 '13 at 18:04
3

@xiaoyi what do you recommend to using besides gettext? – digout Aug 31 '15 at 08:32
7

The gettext libs are used by Wordpress for its native i18n... I think it's going to be in use for a very long time. – gillytech Jan 09 '16 at 05:01
Ran in to some segfaults using this :D – Mārtiņš Briedis May 29 '18 at 19:31

Praveen D · Answer 2 · 2013-09-23T11:27:11.760

14

I called clearstatcache(); function after translating from messages.po to messages.mo and its working fine without restarting apache. Loading each change what I am making in any language file.

edited Sep 23 '13 at 11:27

answered Sep 23 '13 at 06:46

Praveen D

2,337
2
31
43

doesn't work here on docker + php:apache + PHP 7 :( – shaft Sep 24 '20 at 09:36

score 8 · Answer 3 · edited Apr 27 '17 at 10:50

8

ok, in my case I needed to restart phpfpm by doing service php5.6-fpm-sp restart.

If you are using php-fpm you MUST restart phpfpm in order to clear gettext's cache, restarting apache2 doesn't work.

Hope is useful to someone else.

edited Apr 27 '17 at 10:50

Nicolus

33
5

answered Feb 07 '15 at 13:36

chema

531
6
15

Michal Čihař · Answer 4 · 2017-02-10T08:52:53.963

1

There is IMHO no direct way to do that (besides domain workaround you've mentioned), that's reason why we're using php-gettext.

Update: Which we've started to maintain as motranslator, installable by Composer and compatible with all PHP versions.

edited Feb 10 '17 at 08:52

answered Nov 29 '12 at 14:57

Michal Čihař

9,799
6
49
87

Thanks. The code I have is hard coded `gettext()` everywhere, really can't make this switch. – xiaoyi Nov 29 '12 at 15:04
Well the switch is simple replacing gettext by _gettext, what can be done by simple text replacing. – Michal Čihař Nov 29 '12 at 15:04

score 1 · Answer 5 · answered Mar 18 '15 at 14:16

The solution for me was to save the files with a different name, using the date for example, and then changing the domain:

#the path for a domain, the .mo files must match the domain
#the trick to avoid permanent caching, is to use different names for the domain,             like the date messages_180320151250
$domain = 'messages_180320151300';

#sets the path for a domain, the .mo files must match the domain
bindtextdomain($domain, $_SERVER['DOCUMENT_ROOT']."/apps/cp/locale");

textdomain($domain);

score 0 · Answer 6 · answered Apr 03 '18 at 02:56

Use apachectl graceful command to ask the process to re-read the config. It will end the request AFTER the request finished serving. So it looks safe.

According to Apache HTTP Server 2.2 Documentation

The USR1 or graceful signal causes the parent process to advise the children to exit after their current request (or to exit immediately if they're not serving anything). The parent re-reads its configuration files and re-opens its log files. As each child dies off the parent replaces it with a child from the new generation of the configuration, which begins serving new requests immediately.

It worked for me.

How to clear php's gettext cache without restart Apache nor change domain?

6 Answers6

Linked