%PDF-
%PDF-
Mini Shell
Mini Shell
<?php
/**
* Utility for compiling PO data to MO AND JSON files
*/
class Loco_gettext_Compiler {
/**
* @var Loco_api_WordPressFileSystem
*/
private $fs;
/**
* Target file group, where we're compiling to
* @var Loco_fs_Siblings
*/
private $files;
/**
* @var Loco_mvc_ViewParams
*/
private $progress;
/**
* Whether to protect existing files during compilation (i.e. not overwrite them)
* @var bool
*/
private $keep = false;
/**
* Construct with primary file (PO) being saved
* @param Loco_fs_LocaleFile Localised PO file which may or may not exist yet
*/
public function __construct( Loco_fs_LocaleFile $pofile ){
$this->fs = new Loco_api_WordPressFileSystem;
$this->files = new Loco_fs_Siblings($pofile);
$this->progress = new Loco_mvc_ViewParams( [
'pobytes' => 0,
'mobytes' => 0,
'numjson' => 0,
] );
}
/**
* Set overwrite mode
* @param bool whether to overwrite existing files during compilation
* @return self
*/
public function overwrite( $overwrite ){
$this->keep = ! $overwrite;
return $this;
}
/**
* @param Loco_gettext_Data
* @param Loco_package_Project|null
* @return self
*/
public function writeAll( Loco_gettext_Data $po, Loco_package_Project $project = null ){
$this->writePo($po);
$this->writeMo($po);
if( $project ){
$this->writeJson($project,$po);
}
return $this;
}
/**
* @param Loco_gettext_Data PO data
* @return int bytes written to PO file
* @throws Loco_error_WriteException
*/
public function writePo( Loco_gettext_Data $po ){
$file = $this->files->getSource();
// Perform PO file backup before overwriting an existing PO
if( $file->exists() ){
$backups = new Loco_fs_Revisions($file);
$backup = $backups->rotate($this->fs);
// debug backup creation only under cli or ajax. too noisy printing on screen
if( $backup && ( loco_doing_ajax() || 'cli' === PHP_SAPI ) && $backup->exists() ){
Loco_error_AdminNotices::debug( sprintf('Wrote backup: %s -> %s',$file->basename(),$backup->basename() ) );
}
}
$this->fs->authorizeSave($file);
$bytes = $file->putContents( $po->msgcat() );
$this->progress['pobytes'] = $bytes;
return $bytes;
}
/**
* @param Loco_gettext_Data PO data
* @return int bytes written to MO file
*/
public function writeMo( Loco_gettext_Data $po ){
try {
$file = $this->files->getBinary();
$this->fs->authorizeSave($file);
$bytes = $file->putContents( $po->msgfmt() );
$this->progress['mobytes'] = $bytes;
}
catch( Exception $e ){
Loco_error_AdminNotices::debug( $e->getMessage() );
Loco_error_AdminNotices::warn( __('PO file saved, but MO file compilation failed','loco-translate') );
$bytes = 0;
}
return $bytes;
}
/**
* @param Loco_package_Project Translation set, required to resolve script paths
* @param Loco_gettext_Data PO data to export
* @return Loco_fs_FileList All json files created
*/
public function writeJson( Loco_package_Project $project, Loco_gettext_Data $po ){
$domain = $project->getDomain()->getName();
$pofile = $this->files->getSource();
$jsons = new Loco_fs_FileList;
// Allow plugins to dictate a single JSON file to hold all script translations for a text domain
// authors will additionally have to filter at runtime on load_script_translation_file
$path = apply_filters('loco_compile_single_json', '', $pofile->getPath(), $domain );
if( is_string($path) && '' !== $path ){
$refs = $po->splitRefs( $this->getJsExtMap() );
if( array_key_exists('js',$refs) && $refs['js'] instanceof Loco_gettext_Data ){
$jsonfile = new Loco_fs_File($path);
try {
$this->writeFile( $jsonfile, $refs['js']->msgjed($domain,'*.js') );
$jsons->add($jsonfile);
}
catch( Loco_error_WriteException $e ){
Loco_error_AdminNotices::debug( $e->getMessage() );
Loco_error_AdminNotices::warn( sprintf(__('JSON compilation failed for %s','loco-translate'),$jsonfile->basename()) );
}
}
}
// continue as per default, generating multiple per-script JSON
else {
$base_dir = $project->getBundle()->getDirectoryPath();
$buffer = [];
/* @var Loco_gettext_Data $fragment */
foreach( $po->exportRefs('\\.js') as $ref => $fragment ){
$use = null;
// Reference could be source js, or minified version.
// Some build systems may differ, but WordPress only supports this. See WP-CLI MakeJsonCommand.
if( substr($ref,-7) === '.min.js' ) {
$min = $ref;
$src = substr($ref,-7).'.js';
}
else {
$src = $ref;
$min = substr($ref,0,-3).'.min.js';
}
// Try .js and .min.js paths to check whether deployed script actually exists
foreach( [$min,$src] as $try ){
// Hook into load_script_textdomain_relative_path like load_script_textdomain() does.
$url = $project->getBundle()->getDirectoryUrl().$try;
$try = apply_filters( 'load_script_textdomain_relative_path', $try, $url );
if( ! is_string($try) || '' === $try ){
continue;
}
// by default ignore js file that is not in deployed code
$file = new Loco_fs_File($try);
$file->normalize($base_dir);
if( apply_filters('loco_compile_script_reference',$file->exists(),$try,$domain) ){
$use = $try;
break;
}
}
// if neither exists in the bundle, this is a source path that will never be resolved at runtime
if( is_null($use) ){
Loco_error_AdminNotices::debug( sprintf('Skipping JSON for %s; script not found in bundle',$ref) );
}
// add .js strings to buffer for this json and merge if already present
else if( array_key_exists($use,$buffer) ){
$buffer[$use]->concat($fragment);
}
else {
$buffer[$use] = $fragment;
}
}
// write all buffered fragments to their computed JSON paths
foreach( $buffer as $ref => $fragment ) {
$jsonfile = $pofile->cloneJson($ref);
try {
$this->writeFile( $jsonfile, $fragment->msgjed($domain,$ref) );
$jsons->add($jsonfile);
}
catch( Loco_error_WriteException $e ){
Loco_error_AdminNotices::debug( $e->getMessage() );
Loco_error_AdminNotices::warn( sprintf(__('JSON compilation failed for %s','loco-translate'),$ref));
}
}
$buffer = null;
}
// clean up redundant JSONs including if no JSONs were compiled
if( Loco_data_Settings::get()->jed_clean ){
foreach( $this->files->getJsons() as $path ){
$jsonfile = new Loco_fs_File($path);
if( ! $jsons->has($jsonfile) ){
try {
$jsonfile->unlink();
}
catch( Loco_error_WriteException $e ){
Loco_error_AdminNotices::debug('Unable to remove redundant JSON: '.$e->getMessage() );
}
}
}
}
$this->progress['numjson'] = $jsons->count();
return $jsons;
}
/**
* Fetch compilation summary and raise most relevant success message
* @return Loco_mvc_ViewParams
*/
public function getSummary(){
$pofile = $this->files->getSource();
// Avoid calling this unless the initial PO save was successful
if( ! $this->progress['pobytes'] || ! $pofile->exists() ){
throw new LogicException('PO not saved');
}
// Summary for localised file includes MO+JSONs
$mobytes = $this->progress['mobytes'];
$numjson = $this->progress['numjson'];
if( $mobytes && $numjson ){
Loco_error_AdminNotices::success( __('PO file saved and MO/JSON files compiled','loco-translate') );
}
else if( $mobytes ){
Loco_error_AdminNotices::success( __('PO file saved and MO file compiled','loco-translate') );
}
else {
// translators: Where %s is either PO or POT
Loco_error_AdminNotices::success( sprintf(__('%s file saved','loco-translate'),strtoupper($pofile->extension())) );
}
return $this->progress;
}
/**
* @return string[]
*/
private function getJsExtMap(){
$map = ['js'=>'js', 'jsx'=>'js'];
$exts = Loco_data_Settings::get()->jsx_alias;
if( is_array($exts) && $exts ){
foreach( $exts as $ext ){
$map[$ext] = 'js';
}
}
return $map;
}
/**
* @param Loco_fs_File $file
* @param string Serialized JSON to write to given file
* @return int bytes written
*/
public function writeFile( Loco_fs_File $file, $data ){
if( $this->keep && $file->exists() ){
return 0;
}
$this->fs->authorizeSave($file);
return $file->putContents($data);
}
}
Zerion Mini Shell 1.0