Doctrine Project

[PHPCR-96] Clean up event argument classes

Thu, 18 Apr 2013 14:49:25 +0000

clean up the event argument classes to only use specific classes if needed, and base on doctrine commons events

see https://github.com/doctrine/phpcr-odm/pull/246 and https://github.com/doctrine/phpcr-odm/issues/245

[PHPCR-3] add support for lazy loading documents

Fri, 2 Sep 2011 13:09:05 +0000

add support for lazy loading documents

[PHPCR-66] handle ParentDocument and Name changes as move operations

Tue, 5 Jun 2012 11:49:54 +0000

changes to the @ParentDocument and @Name should be translated to move operations. they are the most natural way to move a document in a form.

[PHPCR-10] add support for (weak)references

Fri, 16 Sep 2011 15:08:34 +0000

creating and removing references

[PHPCR-4] add mappings to reference versions in document properties

Fri, 3 Feb 2012 08:11:01 +0000

add mappings to reference versions in document properties

[PHPCR-6] add mappings to reference parents in document properties

Sat, 22 Oct 2011 13:05:36 +0000

add mappings to reference parents in document properties

[PHPCR-32] separate the logic to determine the document class for a node

Sun, 13 Nov 2011 19:09:53 +0000

when loading a node from the database, you can either explicitly specify the document class to be used or it is determined programmatically. you can inject your own logic, but the default logic is right in UnitOfWork, and duplicated. this should be moved to a separate class for better reusability.

this would also be a good moment to get rid of phpcr:alias in favor of phpcr:class. we could provide an implementation for the old phpcr:alias as one of the resolvers users can plug in, if somebody really prefers the alias approach.

[PHPCR-29] Add support to flush only one document through DocumentManager#flush()

Fri, 3 Feb 2012 09:21:00 +0000

see https://github.com/doctrine/doctrine2/pull/166

[PHPCR-27] adding a generic "node" document

Sat, 22 Oct 2011 13:05:04 +0000

see http://groups.google.com/group/symfony-cmf-devs/browse_thread/thread/914ba1c32d873ed5

[PHPCR-25] Github-PR-59 by starkj: Referrers

Fri, 16 Sep 2011 15:07:35 +0000

This issue is created automatically through a Github pull request on behalf of

{username}

Url: https://github.com/doctrine/phpcr-odm/pull/59

Message:

first of all: sry, i screwed up the commit history here again

Well this is support for referrers.
This patch provides the new annotation "Referrers".
By default a property of this type stores all referrers (weak and hard) in a collection.
You can specify the option "referenceType" with the values "weak" and "hard" (or null) to only get the one or the other type of referring documents (or both types)
Then there is the option "filterName". It's value is passed to the method "get(Weak)References". Actually the option passed to "get(Weak)References" is called "name" in the spec. I named it "filterName" here as "name" is already assigned.

[PHPCR-26] Github-PR-56 by uwej711: Fix metadata loading of builtin documents

Sat, 22 Oct 2011 13:04:43 +0000

This issue is created automatically through a Github pull request on behalf of

{username}

Url: https://github.com/doctrine/phpcr-odm/pull/56

Message:

The wrapped metadata driver ensures that metadata for the builtin
documents is loaded. Still the DoctrineAnnotations need to be registered
with the AnnotationRegistry.

see https://github.com/symfony-cmf/cmf-sandbox/issues/20

[PHPCR-22] find('\Foo\Bar', $path) vs find('Foo\Bar', $path)

Thu, 2 Feb 2012 19:27:41 +0000

I just noticed that we have an issue in our metadata loading in case a document name is prefixed with a backslash when calling find

// fails
$dm->find('\Foo\Bar', $path);

// works
$dm->find('Foo\Bar', $path);

Should the first work as well?

I have traced the issue to the DriverChain

public function loadMetadataForClass($className, ClassMetadata $class)
{
foreach ($this->drivers as $namespace => $driver) {
if (strpos($className, $namespace) === 0)

{ $driver->loadMetadataForClass($className, $class); return; }

}

throw MappingException::classIsNotAValidDocument($className);
}

notice the strpos() does not bother to check if a preceding backslash is in the $className var.

[PHPCR-21] converting any existing docs to reST so that it can be added to the site

Mon, 22 Oct 2012 15:02:10 +0000

PHPCR ODM is listed on the Doctrine website:
http://www.doctrine-project.org/projects/phpcr_odm

build doc in this repository:

https://github.com/doctrine/phpcr-odm-documentation

The next step would be to collect all the various documentation flying around and convert them to reST format:
https://github.com/doctrine/phpcr-odm/wiki/_pages
http://melp.nl/2011/07/symfony2-phpcr-doctrine2-jackalope-recipe/ (needs to be made Symfony2 unspecific)
http://www.craftitonline.com/2011/07/first-symfony2-cmf-based-cms-pagesbundle/ (needs to be made Symfony2 unspecific)
http://cmf.symfony.com/slides.html (needs to be made Symfony2 unspecific)

any other articles flying around?

of course we should also reference PHPCR related docs

[PHPCR-16] Annotation for referrers

Fri, 2 Sep 2011 13:11:36 +0000

once reference annotation in ~~PHPCR-10~~ is finished, we should also map the inverse, the list of documents referencing this document. this is a read only property.

[PHPCR-17] Id generator and failsafe storage

Sat, 22 Oct 2011 13:04:25 +0000

Have an id generator that can build the path (id) from parent node and node name.
(The current setup with the id being the path leaves it to the user to make sure the parent node exists. You get really non-helpful strange error message if the parent does not exist.)

[PHPCR-14] refactor document class detection

Mon, 8 Aug 2011 11:34:29 +0000

make document class detection strategy injected. this is in Doctrine/ODM/PHPCR/UnitOfWork.php createDocument

the default strategy should do the current behaviour in that method, but use the explicit parameter first if specified before looking at the phpcr:class attribute.

[PHPCR-18] Documentation

Wed, 3 Aug 2011 10:02:30 +0000

Create better user documentation. The README is far too long, split it.
Create some documents for the doctrine website and do a doctrine-project.org/projects/phpcr_odm

[PHPCR-15] Node property mappings

Sat, 22 Oct 2011 13:03:55 +0000

Annotation to map node name to a field (read-only except when creating a document). should be NodeName because NAME is one of the property types.
Align the annotations with the PHPCR\PropertyType types and map all types (missing for example the PATH type).

[PHPCR-12] Use PHPCR\FactoryInterface to bootstrap

Mon, 8 Aug 2011 11:23:37 +0000

The phpcr-odm should use the factory implementations to bootstrap the phpcr implementation, instead of using new Repository (and jackalope transport and whatnot)

[PHPCR-54] Implement LazyLoad for MANY_TO_ONE referenced docs

Wed, 22 Feb 2012 09:28:54 +0000

MANY_TO_MANY referenced are now only loaded on demand (see ~~PHPCR-52~~) via the ReferenceManyCollection. But MANY_TO_ONE are not yet, to be implemented

[PHPCR-48] add a way to move() nodes

Mon, 13 Feb 2012 13:45:04 +0000

add a way to move() nodes

[PHPCR-46] ensure that parent mappings are populated after flush

Fri, 20 Jul 2012 07:59:34 +0000

https://github.com/doctrine/phpcr-odm/pull/97#r410832

[PHPCR-41] MappingException: Class Doctrine\ODM\PHPCR\ReferrersCollection is not a valid document or mapped super class.

Sun, 8 Jan 2012 19:43:06 +0000

reported by nacmartin https://github.com/symfony-cmf/symfony-cmf/issues/131

Since this property was introduced

https://github.com/symfony-cmf/symfony-cmf/blob/master/src/Symfony/Cmf/Bundle/ContentBundle/Document/StaticContent.php#L44

I have this error when persisting this kind of document in SAB:

MappingException: Class Doctrine\ODM\PHPCR\ReferrersCollection is not a valid document or mapped super class.

Any clue?

=> phpcr-odm should not try to persist a ReferrersCollection. this is just the inverse of the Reference annotation. as this is directional in phpcr, the ReferrersCollection should be immutable by the client.

[PHPCR-39] support ArrayCollection with References/Referrers

Fri, 3 Feb 2012 07:31:31 +0000

support ArrayCollection with References/Referrers

[PHPCR-33] ReferenceOne: targetDocument parameter should be optional

Sun, 13 Nov 2011 19:16:57 +0000

the targetDocument describes what class to expect in the reference. as the class is usually determined automatically, this parameter should be optional.

[PHPCR-75] Mapped Superclass cleanup and documentation

Thu, 10 Jan 2013 12:02:42 +0000

this is a follow-up for https://github.com/doctrine/phpcr-odm/pull/144#issuecomment-7096029

we need to check if mapped superclass is working as it should, and then clarify the doc at https://github.com/doctrine/phpcr-odm-documentation/blob/master/en/reference/inheritance-mapping.rst

i still did not understand what exactly the feature means.

[PHPCR-74] [translations] allow detached document with locale propagation to mapped associations

Fri, 1 Feb 2013 10:20:08 +0000

managed documents can only ever exist once per DocumentManager, and thus only in one language. for this reason we did not want to make the language propagate for mapped children and references (as this would change the content of documents in a hard to understand way - and loading anything in a different language again would still lose the language)

thus we should provide a findTranslation variant to get a detached translated document that fetches all associations as detached as well, keeping the locale setting.

there is no way to handle the write case, but this would cover the read case.

[PHPCR-65] find with uuid creates duplicate of document

Fri, 20 Jul 2012 07:51:56 +0000

i am pretty sure the DocumentManager::find() method creates a duplicate document each time you request the document by uuid. it should not just load the node but convert that node to a path and then do the check if the document is cached. if the node is already cached the lookup by uuid is cheap. if not, it is now cached and the lookup by path is cheap. so no overhead, but eliminate the risk of having several instances of the same document.

https://github.com/doctrine/phpcr-odm/blob/master/lib/Doctrine/ODM/PHPCR/DocumentManager.php#L279

[PHPCR-64] add support for child prefetching

Wed, 18 Jul 2012 22:07:48 +0000

https://github.com/jackalope/jackalope/pull/113

the idea would be to set the depth via a mapping on a per model or per collection basis

[PHPCR-63] event system: prePersist and postPersist

Tue, 22 May 2012 11:20:46 +0000

according to http://docs.doctrine-project.org/projects/doctrine-orm/en/2.1/reference/events.html#prepersist the persist event is only triggered when persisting a new entity/document. but currently the phpcr-odm uow triggers it during the flush operation.

we have to go over the event system and clean that up.

[PHPCR-98] replace child document

Sat, 2 Mar 2013 11:59:43 +0000

when replacing a mapped child with a new document, we get the cannotMoveByAssignment exception, which imo is a) the wrong message as its not about setting a tracked document to become a child somewhere else but what we should do is delete the existing child document and add the new one.

this happens at https://github.com/doctrine/phpcr-odm/blob/master/lib/Doctrine/ODM/PHPCR/UnitOfWork.php#L1912

for multiple children, i am less sure how it should work, if it is possible the same way:
https://github.com/doctrine/phpcr-odm/blob/master/lib/Doctrine/ODM/PHPCR/UnitOfWork.php#L935

[PHPCR-88] locales mapping for language fallback: do not repeat language

Thu, 18 Apr 2013 12:49:12 +0000

currently the language fallback is defined like this

locales:
en: [en, de]
de: [de, en]

the first option must be the requested language. this is counterintuitive and error prone. saying "en: [de]" would make english always only try german. we should add the locale itself as first locale i think, i see no use case of defining fallbacks where the requested locale is not the one to be preferred.

[PHPCR-99] Support configuring mixin node types

Thu, 18 Apr 2013 12:51:38 +0000

we should have a document level mapping to declare arbitrary mixins (like mix:created and mix:lastModified to have autogenerated timestamp fields that then can be mapped)

[PHPCR-89] child documents are not translateable?

Thu, 18 Apr 2013 12:58:03 +0000

I just tried the odm on a testproject. but i have a really strange problem with translations. if i add a document which has children - and then try to add a translation to the children documents - the translation will not be saved .... (i tried the same with the symfony cmf - same result )
code:

[PHPCR-106] Make getRefererrs return not-yet-flushed referring documents

Thu, 18 Apr 2013 13:03:25 +0000

Currently the DocumentManager->getReferrers() method returns only referrers that have already been flushed to the database.

It is (I think) desireable for this method to return also those objects which have been added to the UnitOfWork but have not yet been flushed to the database.

[PHPCR-87] the document manager did not return a result for findBy(array('id' => 'some/id')) but does for find('some/id')

Fri, 19 Apr 2013 10:26:14 +0000

the document manager did not return a result for findBy(array('id' => 'some/id')) but does for find('some/id')

[PHPCR-20] Quality assurance and testing

Wed, 28 Dec 2011 23:31:50 +0000

Look at test coverage and write more tests if necessary. Focus on the exposed api functional tests so the changes to share code with mongo db ~~PHPCR-19~~ can be tested.

[PHPCR-56] Support Hashmaps in fields

Reference — Mon, 22 Oct 2012 14:57:24 +0000

we should have an annotation to have multivalue properties be hashmaps, that is arrays with custom keys that get preserved. there are 3 options:

two multivalue fields with keys and values respectively. see i.e. https://github.com/symfony-cmf/symfony-cmf/pull/140 (another workaround can be to use the @PostLoad and @PreUpdate hooks to split/merge the arrays)
serialize the array into a string field
child nodes (performance penalty). they would need to be in a special namespace to be identifyable and have a special format. a node for key-value is a lot. if you want a document with a specific name, you should use child documents directly, not a hashmap with document entry.

[PHPCR-40] implement inheritance inside find()

Mon, 18 Feb 2013 18:11:40 +0000

meaning if B extends A and someone does ->find('A') that it would find instances of B
this will require changes to ClassMetadataFactory::doLoadMetadata()
https://github.com/doctrine/phpcr-odm/blob/master/lib/Doctrine/ODM/PHPCR/Mapping/ClassMetadataFactory.php#L119

[PHPCR-82] add support to check if a multivalue property of type array actually changed or not

Thu, 18 Apr 2013 13:06:16 +0000

right now we only really support checking the dirty state of MultivaluePropertyCollection instances. however in some cases it might be necessary to convert things to an array, even if there are no actual changes. therefore it would be good to also check the dirty state in case of an array

[PHPCR-45] add ability to prime collections

Thu, 18 Apr 2013 13:08:19 +0000

https://github.com/doctrine/mongodb-odm/commit/2da6e9c92d515edae7c63233740349e0d272b19b

[PHPCR-76] add support for Selectable in PersistentCollection

Thu, 18 Apr 2013 13:06:48 +0000

add support for Selectable in PersistentCollection