/var/www/vhosts/ihelp.ro/httpdocs/vendor/cakephp/bake/src/View/Helper
Edit: /var/www/vhosts/ihelp.ro/httpdocs/vendor/cakephp/bake/src/View/Helper/DocBlockHelper.php (11660B)
$annotations An array of PHP comment block annotations.
* @return string The DocBlock for a class header.
*/
public function classDescription(string $className, string $classType, array $annotations): string
{
$lines = [];
if ($className && $classType) {
$lines[] = "{$className} {$classType}";
}
if ($annotations && $lines) {
$lines[] = '';
}
$previous = false;
foreach ($annotations as $annotation) {
if (strlen($annotation) > 1 && $annotation[0] === '@' && strpos($annotation, ' ') > 0) {
$type = substr($annotation, 0, strpos($annotation, ' '));
if (
$this->_annotationSpacing &&
$previous !== false &&
$previous !== $type
) {
$lines[] = '';
}
$previous = $type;
}
$lines[] = $annotation;
}
$lines = array_merge(['/**'], (new Collection($lines))->map(function ($line) {
return rtrim(" * {$line}");
})->toArray(), [' */']);
return implode("\n", $lines);
}
/**
* Converts an entity class type to its DocBlock hint type counterpart.
*
* @param string $type The entity class type (a fully qualified class name).
* @param \Cake\ORM\Association $association The association related to the entity class.
* @return string The DocBlock type
*/
public function associatedEntityTypeToHintType(string $type, Association $association): string
{
$annotationType = $association->type();
if (
$annotationType === Association::MANY_TO_MANY ||
$annotationType === Association::ONE_TO_MANY
) {
return $type . '[]';
}
return $type;
}
/**
* Builds a map of entity columns as DocBlock types for use
* in generating `@property` hints.
*
* This method expects a property schema as generated by
* `\Bake\Shell\Task\ModelTask::getEntityPropertySchema()`.
*
* The generated map has the format of
*
* ```
* [
* 'property-name' => 'doc-block-type',
* ...
* ]
* ```
*
* @see \Bake\Shell\Task\ModelTask::getEntityPropertySchema
* @param array $propertySchema The property schema to use for generating the type map.
* @return array The property DocType map.
*/
public function buildEntityPropertyHintTypeMap(array $propertySchema): array
{
$properties = [];
foreach ($propertySchema as $property => $info) {
if ($info['kind'] === 'column') {
$type = $this->columnTypeToHintType($info['type']);
if (!empty($info['null'])) {
$type .= '|null';
}
$properties[$property] = $type;
}
}
return $properties;
}
/**
* Builds a map of entity associations as DocBlock types for use
* in generating `@property` hints.
*
* This method expects a property schema as generated by
* `\Bake\Shell\Task\ModelTask::getEntityPropertySchema()`.
*
* The generated map has the format of
*
* ```
* [
* 'property-name' => 'doc-block-type',
* ...
* ]
* ```
*
* @see \Bake\Shell\Task\ModelTask::getEntityPropertySchema
* @param array $propertySchema The property schema to use for generating the type map.
* @return array The property DocType map.
*/
public function buildEntityAssociationHintTypeMap(array $propertySchema): array
{
$properties = [];
foreach ($propertySchema as $property => $info) {
if ($info['kind'] === 'association') {
$type = $this->associatedEntityTypeToHintType($info['type'], $info['association']);
if ($info['association']->type() === Association::MANY_TO_ONE) {
$properties = $this->_insertAfter(
$properties,
$info['association']->getForeignKey(),
[$property => $type]
);
} else {
$properties[$property] = $type;
}
}
}
return $properties;
}
/**
* Converts a column type to its DocBlock type counterpart.
*
* This method only supports the default CakePHP column types,
* for custom column/database types `'string'` will be returned.
*
* @see \Cake\Database\Type
* @param string $type The column type.
* @return string|null The DocBlock type, or `'string'` for unsupported column types.
*/
public function columnTypeToHintType(string $type): ?string
{
switch ($type) {
case 'char':
case 'string':
case 'text':
case 'uuid':
case 'decimal':
return 'string';
case 'integer':
case 'biginteger':
case 'smallinteger':
case 'tinyinteger':
return 'int';
case 'float':
return 'float';
case 'boolean':
return 'bool';
case 'array':
case 'json':
return 'array';
case 'binary':
return 'string|resource';
case 'date':
case 'datetime':
case 'datetimefractional':
case 'time':
case 'timestamp':
case 'timestampfractional':
case 'timestamptimezone':
$dbType = TypeFactory::build($type);
if (method_exists($dbType, 'getDateTimeClassName')) {
return '\\' . $dbType->getDateTimeClassName();
}
return '\Cake\I18n\Time';
}
// Any unique or custom types will have a `string` type hint
return 'string';
}
/**
* Renders a map of DocBlock property types as an array of
* `@property` hints.
*
* @param string[] $properties A key value pair where key is the name of a property and the value is the type.
* @return string[]
*/
public function propertyHints(array $properties): array
{
$lines = [];
foreach ($properties as $property => $type) {
$type = $type ? $type . ' ' : '';
$lines[] = "@property {$type}\${$property}";
}
return $lines;
}
/**
* Build property, method, mixing annotations for table class.
*
* @param array $associations Associations list.
* @param array $associationInfo Association info.
* @param array $behaviors Behaviors list.
* @param string $entity Entity name.
* @param string $namespace Namespace.
* @return string[]
*/
public function buildTableAnnotations(
array $associations,
array $associationInfo,
array $behaviors,
string $entity,
string $namespace
): array {
$annotations = [];
foreach ($associations as $type => $assocs) {
foreach ($assocs as $assoc) {
$typeStr = Inflector::camelize($type);
if (isset($associationInfo[$assoc['alias']])) {
$tableFqn = $associationInfo[$assoc['alias']]['targetFqn'];
$annotations[] = "@property {$tableFqn}&\Cake\ORM\Association\\{$typeStr} \${$assoc['alias']}";
}
}
}
// phpcs:disable
$annotations[] = "@method \\{$namespace}\\Model\\Entity\\{$entity} newEmptyEntity()";
$annotations[] = "@method \\{$namespace}\\Model\\Entity\\{$entity} newEntity(array \$data, array \$options = [])";
$annotations[] = "@method \\{$namespace}\\Model\\Entity\\{$entity}[] newEntities(array \$data, array \$options = [])";
$annotations[] = "@method \\{$namespace}\\Model\\Entity\\{$entity} get(\$primaryKey, \$options = [])";
$annotations[] = "@method \\{$namespace}\\Model\\Entity\\{$entity} findOrCreate(\$search, ?callable \$callback = null, \$options = [])";
$annotations[] = "@method \\{$namespace}\\Model\\Entity\\{$entity} patchEntity(\\Cake\\Datasource\\EntityInterface \$entity, array \$data, array \$options = [])";
$annotations[] = "@method \\{$namespace}\\Model\\Entity\\{$entity}[] patchEntities(iterable \$entities, array \$data, array \$options = [])";
$annotations[] = "@method \\{$namespace}\\Model\\Entity\\{$entity}|false save(\\Cake\\Datasource\\EntityInterface \$entity, \$options = [])";
$annotations[] = "@method \\{$namespace}\\Model\\Entity\\{$entity} saveOrFail(\\Cake\\Datasource\\EntityInterface \$entity, \$options = [])";
$annotations[] = "@method \\{$namespace}\\Model\\Entity\\{$entity}[]|\Cake\Datasource\ResultSetInterface|false saveMany(iterable \$entities, \$options = [])";
$annotations[] = "@method \\{$namespace}\\Model\\Entity\\{$entity}[]|\Cake\Datasource\ResultSetInterface saveManyOrFail(iterable \$entities, \$options = [])";
$annotations[] = "@method \\{$namespace}\\Model\\Entity\\{$entity}[]|\Cake\Datasource\ResultSetInterface|false deleteMany(iterable \$entities, \$options = [])";
$annotations[] = "@method \\{$namespace}\\Model\\Entity\\{$entity}[]|\Cake\Datasource\ResultSetInterface deleteManyOrFail(iterable \$entities, \$options = [])";
// phpcs:enable
foreach ($behaviors as $behavior => $behaviorData) {
$className = App::className($behavior, 'Model/Behavior', 'Behavior');
if (!$className) {
$className = "Cake\ORM\Behavior\\{$behavior}Behavior";
}
$annotations[] = '@mixin \\' . $className;
}
return $annotations;
}
/**
* Inserts a value after a specific key in an associative array.
*
* In case the given key cannot be found, the value will be appended.
*
* @param array $target The array in which to insert the new value.
* @param string $key The array key after which to insert the new value.
* @param mixed $value The entry to insert.
* @return array The array with the new value inserted.
*/
protected function _insertAfter(array $target, string $key, $value): array
{
$index = array_search($key, array_keys($target));
if ($index !== false) {
$target = array_merge(
array_slice($target, 0, $index + 1),
$value,
array_slice($target, $index + 1, null)
);
} else {
$target += (array)$value;
}
return $target;
}
}