Language string extractor
int
1
int
0
int
Count number of marker errors found
string[]
An array of directories to exclude.
bool
Holds whether this call should extract the CakePHP Lib messages
string
Current file being processed
string[]
Files from where to extract
bool
Displays marker error(s) if true
bool
Merge all domain strings into the default.pot file
(callable|\Cake\Datasource\Locator\LocatorInterface)[]
A list of overridden model factory functions.
string
The model type to use.
string
Destination path
string[]
Paths to use when looking for strings
bool
Use relative paths in the pot files rather than full path
array
Contains all content waiting to be write
\Cake\ORM\Locator\LocatorInterface|null
Table locator instance
array
Extracted tokens
array
Extracted strings indexed by domain.
string|null
This object's primary model class name. Should be a plural form.
string
The name of this command.
Returns whether this execution is meant to extract string only from directories in folder represented by the APP constant, i.e. this task is extracting strings from same application.
Convenience method to write a message to Log. See Log::write() for more information on writing to logs.
__construct()
Constructor
By default CakePHP will construct command objects when building the CommandCollection for your application.
_addTranslation(string $domain, string $msgid, array $details)
Add a translation to the internal translations property
Takes care of duplicate translations
string
$domain The domain
string
$msgid The message string
array
$details optional Context and plural form if any, file and line references
_buildFiles(\Cake\Console\Arguments $args)
Build the translate template file contents out of obtained strings
\Cake\Console\Arguments
$args Console arguments
_extract(\Cake\Console\Arguments $args, \Cake\Console\ConsoleIo $io)
Extract text
\Cake\Console\Arguments
$args The Arguments instance
\Cake\Console\ConsoleIo
$io The io instance
_extractTokens(\Cake\Console\Arguments $args, \Cake\Console\ConsoleIo $io)
Extract tokens out of all files to be processed
\Cake\Console\Arguments
$args The io instance
\Cake\Console\ConsoleIo
$io The io instance
_formatString(string $string)
Format a string to be added as a translatable string
string
$string String to format
string
Formatted string
_getPaths(\Cake\Console\ConsoleIo $io)
Method to interact with the user and get path selections.
\Cake\Console\ConsoleIo
$io The io instance.
_getStrings(int $position, int $target)
Get the strings from the position forward
int
$position Actual position on tokens array
int
$target Number of strings to extract
array
Strings extracted
_isExtractingApp()
Returns whether this execution is meant to extract string only from directories in folder represented by the APP constant, i.e. this task is extracting strings from same application.
bool
_isPathUsable(mixed $path)
Checks whether or not a given path is usable for writing.
string
$path Path to folder
bool
true if it exists and is writable, false otherwise
_markerError(mixed $io, string $file, int $line, string $marker, int $count)
Indicate an invalid marker on a processed file
\Cake\Console\ConsoleIo
$io The io instance.
string
$file File where invalid marker resides
int
$line Line number
string
$marker Marker found
int
$count Count
_parse(\Cake\Console\ConsoleIo $io, string $functionName, array $map)
Parse tokens
\Cake\Console\ConsoleIo
$io The io instance
string
$functionName Function name that indicates translatable string (e.g: '__')
array
$map Array containing what variables it will find (e.g: domain, singular, plural)
_searchFiles()
Search files that may contain translatable strings
_setModelClass(string $name)
Set the modelClass property based on conventions.
If the property is already set it will not be overwritten
string
$name Class name.
_store(string $domain, string $header, string $sentence)
Prepare a file to be stored
string
$domain The domain
string
$header The header content.
string
$sentence The sentence to store.
_writeFiles(\Cake\Console\Arguments $args, \Cake\Console\ConsoleIo $io)
Write the files that need to be stored
\Cake\Console\Arguments
$args The command arguments.
\Cake\Console\ConsoleIo
$io The console io
_writeHeader(string $domain)
Build the translation template header
string
$domain Domain
string
Translation template header
abort(int $code)
Halt the the current process with a StopException.
int
$code optional The exit code to use.
Cake\Console\Exception\StopException
buildOptionParser(\Cake\Console\ConsoleOptionParser $parser)
Gets the option parser instance and configures it.
\Cake\Console\ConsoleOptionParser
$parser The parser to configure
\Cake\Console\ConsoleOptionParser
checkUnchanged(string $oldFile, int $headerLength, string $newFileContent)
Check whether the old and new output are the same, thus unchanged
Compares the sha1 hashes of the old and new file without header.
string
$oldFile The existing file.
int
$headerLength The length of the file header in bytes.
string
$newFileContent The content of the new file.
bool
Whether or not the old and new file are unchanged.
defaultName()
Get the command name.
Returns the command name based on class name. For e.g. for a command with class name UpdateTableCommand
the default name returned would be 'update_table'
.
string
displayHelp(\Cake\Console\ConsoleOptionParser $parser, \Cake\Console\Arguments $args, \Cake\Console\ConsoleIo $io)
Output help content
\Cake\Console\ConsoleOptionParser
$parser The option parser.
\Cake\Console\Arguments
$args The command arguments.
\Cake\Console\ConsoleIo
$io The console io
execute(\Cake\Console\Arguments $args, \Cake\Console\ConsoleIo $io)
Execute the command
\Cake\Console\Arguments
$args The command arguments.
\Cake\Console\ConsoleIo
$io The console io
int|null
The exit code or null for success
executeCommand(mixed $command, array $args, ?\Cake\Console\ConsoleIo $io)
Execute another command with the provided set of arguments.
string|\Cake\Console\CommandInterface
$command The command class name or command instance.
array
$args optional The arguments to invoke the command with.
\Cake\Console\ConsoleIo
$io optional The ConsoleIo instance to use for the executed command.
int|null
The exit code or null for success of the command.
getModelType()
Get the model type to be used by this class
string
getName()
Get the command name.
string
getOptionParser()
Get the option parser.
You can override buildOptionParser() to define your options & arguments.
\Cake\Console\ConsoleOptionParser
RuntimeException
getRootName()
Get the root command name.
string
getTableLocator()
Gets the table locator.
\Cake\ORM\Locator\LocatorInterface
initialize()
Hook method invoked by CakePHP when a command is about to be executed.
Override this method and implement expensive/important setup steps that should not run on every command run. This method will be called before the options and arguments are validated and processed.
loadModel(?string $modelClass, ?string $modelType)
Loads and constructs repository objects required by this object
Typically used to load ORM Table objects as required. Can also be used to load other types of repository objects your application uses.
If a repository provider does not return an object a MissingModelException will be thrown.
string|null
$modelClass optional Name of model class to load. Defaults to $this->modelClass. The name can be an alias like 'Post'
or FQCN like App\Model\Table\PostsTable::class
.
string|null
$modelType optional The type of repository to load. Defaults to the getModelType() value.
\Cake\Datasource\RepositoryInterface
The model instance created.
Cake\Datasource\Exception\MissingModelException
UnexpectedValueException
log(string $message, mixed $level, mixed $context)
Convenience method to write a message to Log. See Log::write() for more information on writing to logs.
string
$message Log message.
int|string
$level optional Error level.
string|array
$context optional Additional log data relevant to this message.
bool
Success of log write.
modelFactory(string $type, mixed $factory)
Override a existing callable to generate repositories of a given type.
string
$type The name of the repository type the factory function is for.
callable|\Cake\Datasource\Locator\LocatorInterface
$factory The factory function used to create instances.
run(array $argv, \Cake\Console\ConsoleIo $io)
Run the command.
array
$argv Arguments from the CLI environment.
\Cake\Console\ConsoleIo
$io The console io
int|null
Exit code or null for success.
setModelType(string $modelType)
Set the model type to be used by this class
string
$modelType The model type
$this
setName(string $name)
Set the name this command uses in the collection.
Generally invoked by the CommandCollection when the command is added. Required to have at least one space in the name so that the root command can be calculated.
string
$name The name the command uses in the collection.
$this
InvalidArgumentException
setOutputLevel(\Cake\Console\Arguments $args, \Cake\Console\ConsoleIo $io)
Set the output level based on the Arguments.
\Cake\Console\Arguments
$args The command arguments.
\Cake\Console\ConsoleIo
$io The console io
setTableLocator(\Cake\ORM\Locator\LocatorInterface $tableLocator)
Sets the table locator.
\Cake\ORM\Locator\LocatorInterface
$tableLocator LocatorInterface instance.
$this
Count number of marker errors found
int
An array of directories to exclude.
string[]
Holds whether this call should extract the CakePHP Lib messages
bool
Current file being processed
string
Files from where to extract
string[]
Displays marker error(s) if true
bool
Merge all domain strings into the default.pot file
bool
A list of overridden model factory functions.
(callable|\Cake\Datasource\Locator\LocatorInterface)[]
The model type to use.
string
Destination path
string
Paths to use when looking for strings
string[]
Use relative paths in the pot files rather than full path
bool
Contains all content waiting to be write
array
Table locator instance
\Cake\ORM\Locator\LocatorInterface|null
Extracted tokens
array
Extracted strings indexed by domain.
array
This object's primary model class name. Should be a plural form.
CakePHP will not inflect the name.
Example: For an object named 'Comments', the modelClass would be 'Comments'. Plugin classes should use Plugin.Comments
style names to correctly load models from the correct plugin.
Use empty string to not use auto-loading on this object. Null auto-detects based on controller name.
string|null
The name of this command.
string
© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/4.1/class-Cake.Command.I18nExtractCommand.html