* @license MIT License (http://www.opensource.org/licenses/mit-license.php) */ class Annotation extends AbstractAnnotationDriver { /** * Annotation to identify field as one which holds the slug * together with slug options */ const SLUG = 'Gedmo\\Mapping\\Annotation\\Slug'; /** * SlugHandler extension annotation */ const HANDLER = 'Gedmo\\Mapping\\Annotation\\SlugHandler'; /** * SlugHandler option annotation */ const HANDLER_OPTION ='Gedmo\\Mapping\\Annotation\\SlugHandlerOption'; /** * List of types which are valid for slug and sluggable fields * * @var array */ protected $validTypes = array( 'string', 'text', 'integer', 'int', ); /** * {@inheritDoc} */ public function readExtendedMetadata($meta, array &$config) { $class = $this->getMetaReflectionClass($meta); // property annotations foreach ($class->getProperties() as $property) { if ($meta->isMappedSuperclass && !$property->isPrivate() || $meta->isInheritedField($property->name) || isset($meta->associationMappings[$property->name]['inherited']) ) { continue; } // slug property if ($slug = $this->reader->getPropertyAnnotation($property, self::SLUG)) { $field = $property->getName(); if (!$meta->hasField($field)) { throw new InvalidMappingException("Unable to find slug [{$field}] as mapped property in entity - {$meta->name}"); } if (!$this->isValidField($meta, $field)) { throw new InvalidMappingException("Cannot use field - [{$field}] for slug storage, type is not valid and must be 'string' or 'text' in class - {$meta->name}"); } // process slug handlers $handlers = array(); if (is_array($slug->handlers) && $slug->handlers) { foreach ($slug->handlers as $handler) { if (!$handler instanceof SlugHandler) { throw new InvalidMappingException("SlugHandler: {$handler} should be instance of SlugHandler annotation in entity - {$meta->name}"); } if (!strlen($handler->class)) { throw new InvalidMappingException("SlugHandler class: {$handler->class} should be a valid class name in entity - {$meta->name}"); } $class = $handler->class; $handlers[$class] = array(); foreach ((array)$handler->options as $option) { if (!$option instanceof SlugHandlerOption) { throw new InvalidMappingException("SlugHandlerOption: {$option} should be instance of SlugHandlerOption annotation in entity - {$meta->name}"); } if (!strlen($option->name)) { throw new InvalidMappingException("SlugHandlerOption name: {$option->name} should be valid name in entity - {$meta->name}"); } $handlers[$class][$option->name] = $option->value; } $class::validate($handlers[$class], $meta); } } // process slug fields if (empty($slug->fields) || !is_array($slug->fields)) { throw new InvalidMappingException("Slug must contain at least one field for slug generation in class - {$meta->name}"); } foreach ($slug->fields as $slugField) { if (!$meta->hasField($slugField)) { throw new InvalidMappingException("Unable to find slug [{$slugField}] as mapped property in entity - {$meta->name}"); } if (!$this->isValidField($meta, $slugField)) { throw new InvalidMappingException("Cannot use field - [{$slugField}] for slug storage, type is not valid and must be 'string' or 'text' in class - {$meta->name}"); } } if (!is_bool($slug->updatable)) { throw new InvalidMappingException("Slug annotation [updatable], type is not valid and must be 'boolean' in class - {$meta->name}"); } if (!is_bool($slug->unique)) { throw new InvalidMappingException("Slug annotation [unique], type is not valid and must be 'boolean' in class - {$meta->name}"); } if (!empty($meta->identifier) && $meta->isIdentifier($field) && !(bool)$slug->unique) { throw new InvalidMappingException("Identifier field - [{$field}] slug must be unique in order to maintain primary key in class - {$meta->name}"); } if ($slug->unique === false && $slug->unique_base) { throw new InvalidMappingException("Slug annotation [unique_base] can not be set if unique is unset or 'false'"); } if ($slug->unique_base && !$meta->hasField($slug->unique_base) && !$meta->hasAssociation($slug->unique_base)) { throw new InvalidMappingException("Unable to find [{$slug->unique_base}] as mapped property in entity - {$meta->name}"); } // set all options $config['slugs'][$field] = array( 'fields' => $slug->fields, 'slug' => $field, 'style' => $slug->style, 'updatable' => $slug->updatable, 'unique' => $slug->unique, 'unique_base' => $slug->unique_base, 'separator' => $slug->separator, 'prefix' => $slug->prefix, 'suffix' => $slug->suffix, 'handlers' => $handlers, ); } } } }