Doctrine Project

[DWEB-111] http://wiki.doctrine-project.org/ not working

Wed, 12 Dec 2012 13:29:14 +0000

return a 500 the last few Days

[DWEB-110] Cannot access API documentation because of redirect loop

Fri, 30 Nov 2012 00:37:43 +0000

http://www.doctrine-project.org/api/orm/2.2/

Trying to access the URL above results in a redirect loop.

[DWEB-109] Add timestamp to blogposts

Mon, 16 Jul 2012 14:36:40 +0000

Timestamps are missing in blogposts, and that makes it quite hard to locate release dates basing on the blog.

[DWEB-108] API - ORM 2.2

Thu, 26 Apr 2012 23:20:21 +0000

At http://www.doctrine-project.org/api/orm/2.2/ is APIDoc for 2.1.6 not 2.2.x (2.2.2) see http://www.doctrine-project.org/api/orm/2.2/class-Doctrine.ORM.Version.html

[DWEB-107] Broken links on the official project page

Mon, 9 Apr 2012 21:24:00 +0000

Hi,

I would like to report few broken links.

In the migration project page http://www.doctrine-project.org/projects/migrations.html, documentation link(http://www.doctrine-project.org/docs/migrations/2.0/en/index.html) is broken.

In the project page http://www.doctrine-project.org/projects.html, MongoDB Object Document Mapper Section link (http://www.doctrine-project.org/projects/mongodb_odm.html) and its download link(http://www.doctrine-project.org/projects/mongodb_odm.html) are broken

[DWEB-106] Dead links on projects page

Sun, 29 Jul 2012 01:31:38 +0000

API & Documentation links about migrations tool are dead
http://www.doctrine-project.org/projects.html

[DWEB-105] tools documentation for Non-PEAR command line points to wrong EntityManagerHelper

Wed, 15 Feb 2012 20:54:34 +0000

http://docs.doctrine-project.org/projects/doctrine-orm/en/2.1/reference/tools.html

Line reads:

use Doctrine\DBAL\Tools\Console\Helper\EntityManagerHelper;

Should be:

use Doctrine\ORM\Tools\Console\Helper\EntityManagerHelper;

[DWEB-103] Wrong DateTimeZone initiation in ORM cookbook

Thu, 29 Dec 2011 15:15:41 +0000

In page http://www.doctrine-project.org/docs/orm/2.1/en/cookbook/working-with-datetime.html should be

new \DateTimeZone('UTC')

instead of

new \DateTimeZone(\DateTimeZone::UTC)

The latter fails.

[DWEB-102] Query Builder's substring helper errors

Fri, 23 Dec 2011 19:52:33 +0000

There are a couple problems with the query builder substring helper documentation.

1. It lists the method as "substr" when it is "substring"
2. it shows it using a 0 offset as the beginning of the value when it should be 1.

[DWEB-101] Typo in documentation

Sat, 31 Dec 2011 03:48:45 +0000

http://www.doctrine-project.org/docs/orm/2.1/en/reference/tools.html

line:
Converting an existing databsae schema
should be:
Converting an existing database schema

[DWEB-100] Unreadable color scheme for code blocks

Fri, 9 Dec 2011 09:32:34 +0000

Bad color contrast in documentation, unreadable code blocks in chromium browser, screenshot in attachment, example link - http://www.doctrine-project.org/docs/mongodb_odm/1.0/en/reference/introduction.html

FYI: Firefox has a good color contrast for this blocks.

[DWEB-99] 5.14. Many-To-Many, Bidirectional Missing target-entity

Tue, 6 Dec 2011 19:16:44 +0000

<doctrine-mapping>
<entity name="User">
<many-to-many field="groups" inversed-by="users">
<join-table name="users_groups">
<join-columns>
<join-column="user_id" referenced-column-name="id" />
</join-columns>
<inverse-join-columns>
<join-column="group_id" referenced-column-name="id" />
</inverse-join-columns>
</join-table>
</many-to-many>
</entity>

should be this to work:

<doctrine-mapping>
<entity name="User">
<many-to-many field="groups" inversed-by="users" target-entiy="Group">
<join-table name="users_groups">
<join-columns>
<join-column="user_id" referenced-column-name="id" />
</join-columns>
<inverse-join-columns>
<join-column="group_id" referenced-column-name="id" />
</inverse-join-columns>
</join-table>
</many-to-many>
</entity>

[DWEB-98] XML example errors in section 6 of the manual

Thu, 3 Nov 2011 12:53:01 +0000

I've notice some error in the XML example of the Doctrine ORM manual, section 6.

There is often:
<join-column="user_id" referenced-column-name="id" />
The correct tag should be:
<join-column name="user_id" referenced-column-name="id" />

Also, in the many-to-many bidirectional example is missing the targer-entity tag:
<many-to-many field="groups" inversed-by="users">
Should be:
<many-to-many field="groups" target-entity="Group" inversed-by="users">

I also think that the differents values could be better explained.

Hope this will help...

[DWEB-97] Dead link for DBAL API

Thu, 22 Sep 2011 09:51:03 +0000

Dead link on API for this URL :
http://www.doctrine-project.org/projects/dbal/current/docs/en

Here the dead link : http://www.doctrine-project.org/projects/dbal/2.1/api

The only API DBAL link available is for 2.0 : http://www.doctrine-project.org/projects/dbal/2.0/api

[DWEB-96] Clearly state Doctrine does not support subqueries in FROM part or any other that is not supported

Wed, 17 Aug 2011 13:02:22 +0000

Everywhere I looked (except stackoverflow) was stated that doctrine does support subqueries in the FORM DQL part but this actually is wrong. Doctrine does not support subqueries in the FROM part. Probably somewhere else as well.

http://www.doctrine-project.org/projects/orm/1.2/docs/manual/dql-doctrine-query-language/hu#subqueries
http://www.doctrine-project.org/documentation/manual/1_1/pl/dql-doctrine-query-language:subqueries

[DWEB-95] Huge Documentation Regression - Association Mapping

Fri, 5 Aug 2011 17:15:46 +0000

Some critical mapping information has disappeared from the Association Mapping page. Several examples are completely missing, and others are only showing XML.

Please correct ASAP, as this is a vital reference and it's almost impossible to find elsewhere online.

http://www.doctrine-project.org/docs/orm/2.1/en/reference/association-mapping.html#one-to-many-unidirectional-with-join-table

Thanks,

Scott

[DWEB-94] DBAL 2.1 reference documentation leads to 2.0 beta 4

Wed, 13 Jul 2011 08:43:19 +0000

The reference documentation links to Doctrine DBAL v2.0.0-BETA4 documentation:

http://www.doctrine-project.org/docs/dbal/2.1/en/

I was hoping i could find some info about the new QueryBuilder ( very glad that 2.1 has this feature now! )

[DWEB-93] DBAL api 2.1 page not found

Wed, 13 Jul 2011 08:38:26 +0000

Api 2.1 docs missing
http://www.doctrine-project.org/projects/dbal/2.1/api

[DWEB-92] Incorrect code snippet in cookbook, mysql enums

Wed, 13 Jul 2011 08:36:10 +0000

The codesnippet @solution 1 does not work for me
http://www.doctrine-project.org/docs/orm/2.0/en/cookbook/mysql-enums.html#solution-1-mapping-to-varchars

It did work using :
$con->getDatabasePlatform()->registerDoctrineTypeMapping('enum', 'string');

On a side note: I think loads of users use Mysql (and enums) and it could be helpfull if there are links in de dbal documentation to this page.

[DWEB-91] DBAL 2.1 API Link 404

Tue, 5 Jul 2011 13:39:20 +0000

The link to the DBAL 2.1 API is broken.

[DWEB-89] Generated API doc for Doctrine 2.0 does not use 2.0 codebase

Thu, 23 Jun 2011 13:09:03 +0000

The documentation in the API (http://www.doctrine-project.org/projects/orm/2.0/api) references to functions that are not currently implemented in 2.0 but are in 2.1. For instance, the ORM\Query\Expr mentions the method isNull which is not in 2.06.

Link :
http://www.doctrine-project.org/api/orm/2.0/doctrine/orm/query/expr.html#isNull()

[DWEB-88] Wrong anchor target (404)

Wed, 22 Jun 2011 16:07:59 +0000

There is a wrong anchor to DBAL configuration documentation at http://www.doctrine-project.org/docs/orm/2.0/en/reference/configuration.html#connection-options

diff --git a/en/reference/configuration.rst b/en/reference/configuration.rst
index 27a54c6..a67063f 100644
--- a/en/reference/configuration.rst
+++ b/en/reference/configuration.rst
@@ -356,7 +356,7 @@ instance of ``Doctrine\DBAL\Connection``. If an array is passed it
 is directly passed along to the DBAL Factory
 ``Doctrine\DBAL\DriverManager::getConnection()``. The DBAL
 configuration is explained in the
-`DBAL section <./../../../../../dbal/2.0/docs/reference/configuration/en>`_.
+`DBAL section <./../../../../../docs/dbal/2.0/en/reference/configuration.html>`_.
 
 Proxy Objects
 -------------

This could be a possible fix but i wasn't able to test it due to missing sphinx-build tool.

[DWEB-87] Suggestion: Change the 2.0 to "current" in the docs URL

Fri, 29 Jul 2011 19:19:05 +0000

Hey guys-

This is just a general suggestion about the website - I'm note sure if there's a better place to put this. In Symfony - following PHPUnit's lead - we removed the documentation's version from the URL and replaced it with "current". For Doctrine (taking the ORM as an example), this would mean that:

http://www.doctrine-project.org/docs/orm/2.0/en/

becomes

http://www.doctrine-project.org/docs/orm/current/en/

We made this change in Symfony-land in response to users complaining - from symfony1 - that googling always returned out-of-date documentation. This makes sense if you have the version in the URL, as all of your backlinks will link to a specific version (e.g. "2.0"), keeping the rank on that version high even as it becomes out-of-date.

Just a suggestion! Should be as easy as a symlink, but do with it what you will.

Cheers!

[DWEB-86] Some "Not found" errors

Thu, 31 May 2012 22:24:21 +0000

Downloading the whole documentation for offline reading I found some "Not Found" errors on this links:

www.doctrine-project.org/images/btn-open.png (from www.doctrine-project.org/docs/dbal/2.0/en/_static/default.css)
www.doctrine-project.org/images/error.png (from www.doctrine-project.org/css/layout.css)

www.doctrine-project.org/docs/dbal/2.0/en/reference/types (from www.doctrine-project.org/docs/dbal/2.0/en/reference/data-retrieval-and-manipulation.html)
www.doctrine-project.org/docs/dbal/2.0/en/known-vendor-issues (from www.doctrine-project.org/docs/dbal/2.0/en/reference/types.html)
www.doctrine-project.org/docs/orm/2.0/en/reference/batch-processing (from www.doctrine-project.org/docs/orm/2.0/en/reference/dql-doctrine-query-language.html)

[DWEB-85] Better API generator

Tue, 28 Feb 2012 17:09:10 +0000

Hi guys, am I the only one who hates the current API references?

Try compare

http://www.doctrine-project.org/projects/orm/2.0/api

and

http://api.nella-project.org/framework/namespace-Doctrine.html

The other one was generated by modified version of http://www.apigen.org/, so it can inherit more projects, but in original it looks like http://api.nette.org/2.0/

Thanks for your time

[DWEB-84] Integrate orm-documentation Pull Request #27

Fri, 6 May 2011 01:58:23 +0000

I've written an article for the Doctrine Cookbook, how to persist the decorator pattern with doctrine 2.

the pull request can be found here:
https://github.com/doctrine/orm-documentation/pull/27

Please review. Feedback and edits are welcomed!

[DWEB-83] Migration changeColumn documentation incorrect

Mon, 25 Apr 2011 17:19:50 +0000

It appears that the documentation for changeColumn for migrations is wrong - the fourth argument seems to be the length, and the fifth argument is the array of options.

http://www.doctrine-project.org/projects/orm/1.2/docs/manual/migrations/en#writing-migration-classes:available-operations:change-column

// This Fails:
$this->changeColumn('table_name', 'column_name', 'tinyint', $options);

// This Works:
$this->changeColumn('table_name', 'column_name', 'tinyint', 3, $options);

Trying the former option with decimals caused the error:
"ALTER TABLE uza_population_size CHANGE square_miles square_miles DECIMAL(Array, 2)"

[DWEB-82] Class Definition Missing Parent Class

Mon, 25 Apr 2011 07:02:21 +0000

Class "Bar" should extend "\Doctrine\Common\Annotations\Annotation" as it does in class "Foo".

See http://www.doctrine-project.org/projects/common/2.0/docs/reference/annotations/en#usage

[DWEB-81] Documentation for "Extending DQL in Doctrine 2" is partial and wrong

Sat, 2 Apr 2011 13:45:42 +0000

The references to the FunctionBlock class is wrong.

It says: Doctrine\ORM\Query\Node\FunctionNode

But it should be: Doctrine\ORM\Query\AST\Functions\FunctionNode

Also, the Lexer class is used but does not mention the full class name anywhere, which is: Doctrine\ORM\Query\Lexer

This prevents people for writing DQL functions.

[DWEB-80] Doctrine Mapping Types in "Basic Mapping" page should be copied or moved to "Annotations Reference"

Fri, 1 Apr 2011 17:04:30 +0000

It makes sense that possible mapping types are listed as possible values in the attributes list for @Column in the "Annotations Reference" page: http://www.doctrine-project.org/docs/orm/2.0/en/reference/annotations-reference.html#annref-column

The only place I've been able to find them is in the "Basic Mapping" page: http://www.doctrine-project.org/docs/orm/2.0/en/reference/basic-mapping.html#doctrine-mapping-types

[DWEB-79] Batch Processing Link from DQL ORM Documentation Page is Broken

Thu, 31 Mar 2011 15:05:11 +0000

This page: http://www.doctrine-project.org/docs/orm/2.0/en/reference/dql-doctrine-query-language.html#iterating-large-result-sets

Links to this page: http://www.doctrine-project.org/docs/orm/2.0/en/reference/batch-processing

Which does not exist because it is missing the ".html" suffix.

[DWEB-78] Doctrine2 YAML mapping

Sat, 26 Mar 2011 08:06:50 +0000

In http://www.doctrine-project.org/docs/orm/2.0/en/reference/yaml-mapping.html

oneToMany:
phonenumbers:
targetEntity: Phonenumber
mappedBy: user
cascade: cascadePersist

not working.. I have to change it to

oneToMany:
phonenumbers:
targetEntity: Phonenumber
mappedBy: user
cascade: [cascadePersist]

to work

[DWEB-77] Pending pull requests on github

Thu, 24 Mar 2011 13:36:44 +0000

https://github.com/doctrine/orm-documentation/pulls lists Pull Requests that are there for a couple of months...

I think this is the best way to push corrections. But if it isn't the way to do, you should put a warning saying not to fork.
Cheers

[edit] In fact, there are also old bug issues here either :-P

[DWEB-76] Ordered Lists (arabic simple) incorrectly rendered by the CSS

Thu, 24 Mar 2011 07:07:23 +0000

All explicit ordered lists (see link to sample below) are incorrectly rendered by the default.css file.
The <ol> tag has classes "arabic simple" with correct CSS style but the list-style-type is enforced to none by the css for all <li> tags.

Sample:
http://www.doctrine-project.org/docs/orm/2.0/en/reference/working-with-associations.html#persistence-by-reachability-cascade-persist

[DWEB-75] Little problem in "Getting Started" > "Entity Repositories"

Thu, 24 Mar 2011 02:52:05 +0000

In the Getting Started guide, section "Entity Repositories":

In the PHP tab says
/**

@Entity @Table(name="bugs", repositoryClass="BugRepository")
*/

but the repositoryClass must be in @Entity, you should change this for:

/**

@Entity(repositoryClass="BugRepository") @Table(name="bugs")
*/

[DWEB-74] Downloadable Documentation would be very helpful

Mon, 21 Mar 2011 16:54:03 +0000

It would be great if documentation could be downloaded in, say, pdf form.

[DWEB-73] Missing example in documentation

Fri, 25 Feb 2011 06:03:00 +0000

In 13. The QueryBuilder http://www.doctrine-project.org/docs/orm/2.0/en/reference/query-builder.html

http://www.doctrine-project.org/docs/orm/2.0/en/reference/query-builder.html#executing-a-query

Example code is missing in that part.

$q = $qb->getQuery();

[DWEB-72] Error in Documentation

Thu, 24 Feb 2011 10:39:54 +0000

In reference guide, 12: DQL http://www.doctrine-project.org/docs/orm/2.0/en/reference/dql-doctrine-query-language.html

At 12.7.5.2. Cache related API http://www.doctrine-project.org/docs/orm/2.0/en/reference/dql-doctrine-query-language.html#cache-related-api

There is a tip written in the code block.

*TIP!* You can set the Result Cache Driver globally on the
``Doctrine\ORM\Configuration`` instance so that it is passed to
every ``Query`` and ``NativeQuery`` instance.

[DWEB-71] Documentation need improvement

Wed, 23 Feb 2011 09:05:49 +0000

In reference guide, 12: DQL http://www.doctrine-project.org/docs/orm/2.0/en/reference/dql-doctrine-query-language.html

There is a part for partial object syntax: 12.2.4.1. Partial Object Syntax http://www.doctrine-project.org/docs/orm/2.0/en/reference/dql-doctrine-query-language.html#partial-object-syntax

It should have some reference to 16. Partial Objects chapter as it gives some detailed explanation about the subject and has important notes. http://www.doctrine-project.org/docs/orm/2.0/en/reference/partial-objects.html

Also in chapter 16 it says partial objects are not allowed by default. There is no mention to that in chapter 12 part.

[DWEB-70] Error in Documentation

Wed, 23 Feb 2011 08:17:13 +0000

In reference guide, 12: DQL http://www.doctrine-project.org/docs/orm/2.0/en/reference/dql-doctrine-query-language.html

12.2.4 DQL SELECT Examples

With COUNT DISTINCT:

<?php
$query = $em->createQuery('SELECT COUNT(DISTINCT u.name) FROM CmsUser');
$users = $query->getResult(); // array of ForumUser objects

Alias missing in the query.
It doesn't return ForumUser objects.

—

With Arithmetic Expression in WHERE clause:

<?php
$query = $em->createQuery('SELECT u FROM CmsUser u WHERE ((u.id + 5000) * u.id + 3) < 10000000');
$users = $query->getResult(); // array of ForumUser objects

It doesn't return ForumUser objects.

–

And after these examples the comments on $query->getResult(); that tells what is returned is missing.

[DWEB-69] ORM Documentation Reference typo

Sun, 20 Feb 2011 05:47:48 +0000

Doctrine 2 ORM v2.0.0 documentation
Getting Started
Obtaining the EntityManager

Current version:
In production we use caching only on a per request-basis using the ArrayCache. In production it is literally required to use Apc...

Should be:
In development we use caching only on a per request-basis using the ArrayCache. In production it is literally required to use Apc...

[DWEB-68] Firefox search plugin fixed and improved

Mon, 7 Feb 2011 10:44:02 +0000

Good evening

I implemented the Firefox search plugin - see http://www.doctrine-project.org/jira/browse/DWEB-8 - that is published via the following LINK element in the HEAD of your pages.

The plugin does not work now that structure of your API documentation has changed. I have updated, and improved the plugin. The new download URL follows.

http://dadl.danbettles.net/search_plugins/orm/1.2/download

If you want to view the source first, simply follow http://dadl.danbettles.net/search_plugins/orm/1.2/view_source.

I'm still maintaining the plugin page on Mozilla Add Ons, for now, but by linking to my site, you can be sure that visitors to doctrine-project.org will always get the most up-to-date version.

The biggest, and most useful, change to the plugin is the addition of suggestions. My site regularly indexes your documentation and serves-up suggestions as you type. Should a user press "Enter" without choosing a suggestion in Firefox, a Web page listing all matches will be displayed. If a user types a name that exactly matches an item in the documentation, the relevant page in the API documentation will be displayed.

If the service proves to be useful, I'll make a few changes and publish an ORM 2.0 plugin. I may also set things up to index function names, too.

Sorry it took me so long to update the plugin - it's been a while since I worked with Doctrine, so I hadn't noticed the changes to your site.

Please let me know how you get on.

[DWEB-67] Method error in DBAL doc

Fri, 10 Dec 2010 03:41:03 +0000

On this page =>
http://www.doctrine-project.org/projects/dbal/2.0/docs/reference/data-retrieval-and-manipulation/en#executequery$sql,-array-$params-=-array,-array-$types-=-array

You should use the "executeQuery" method instead of "execute" .... error otherwise.

[DWEB-66] Error in documentation

Sat, 4 Dec 2010 06:29:10 +0000

On page http://www.doctrine-project.org/documentation/manual/2_0/en/tools#the-doctrine-cli:configuration
it says "\Symfony\Components\" and it should be "\Symfony\Component\".

[DWEB-65] Problems with syntax highlighting on some pages

Sun, 28 Nov 2010 16:38:45 +0000

Looks like php open tag is missing
http://www.doctrine-project.org/projects/orm/2.0/docs/reference/association-mapping/en#runtime-vs-development-mapping-validation
http://www.doctrine-project.org/projects/orm/2.0/docs/cookbook/strategy-cookbook-introduction/en#solution

[DWEB-64] wrong resulting sql in Aggregate values

Sat, 20 Nov 2010 21:11:46 +0000

the Aggregate values in the DQL documentation

the following code
$q = Doctrine_Query::create()
->select('u.id, COUNT(t.id) AS num_threads')
->from('User u, u.Threads t')
->where('u.id = ?', 1)
->groupBy('u.id');

echo $q->getSqlQuery();

the documentation says it will result in the following query
SELECT
u.id AS u__id,
COUNT(f.id) AS f__0
FROM user u
LEFT JOIN forum__thread f ON u.id = f.user_id
WHERE u.id = ?
GROUP BY u.id

notice the different, in DQL we are aggregating users with threads, but the resulting sql joins forums not threads.

[DWEB-63] 'details on all the available change tracking policies' on Annotations reference page is broken

Tue, 16 Nov 2010 06:58:57 +0000

The link points to 'http://www.doctrine-project.org/configuration#change-tracking-policies' which can't be found.

[DWEB-62] JIRA: Automatic notification for "all" changes to bugs ignores new comments that are added to bugs

Mon, 8 Nov 2010 16:04:10 +0000

I opened Issue No. ~~DDC-864~~. After creating the bug, I clicked on "watch it".

The "Issue details" page for the issue is confirming it. "You are watching this issue. You will be notified of all changes. "

On 06/Nov/10 05:48 PM and on 06/Nov/10 05:49 PM two comments were added to the issue. I did not receive any notification.

I just noticed right now by polling the open issues I reported.

My email adress is correct (it's shown obfuscated with "dot" instead of "." by JIRA, but I think that's just a presentation thing).

[DWEB-61] date type maps SQL DATE instead of SQL DATETIME to a PHP DateTime object.

Tue, 2 Nov 2010 11:22:39 +0000

At http://www.doctrine-project.org/projects/orm/2.0/docs/reference/basic-mapping/en section "Doctrine mapping types"

date: Type that maps an SQL DATETIME to a PHP DateTime object.

should be

date: Type that maps an SQL DATE to a PHP DateTime object.

[DWEB-60] Doctrine-console tool configuration - wrong namespace

Fri, 1 Oct 2010 03:42:02 +0000

The example helperSet setup in the tools section is currently referencing
"$helperSet = new \Symfony\Components\Console\Hel...."

The correct namespace is "$helperSet = new \Symfony\Component\Console\Hel...."

See: http://www.doctrine-project.org/projects/orm/2.0/docs/reference/tools/en#the-doctrine-console:configuration

[DWEB-59] External resource unavailable (dead link)

Tue, 7 Sep 2010 08:25:08 +0000

URL: http://www.doctrine-project.org/projects/orm/2.0/docs/reference/inheritance-mapping/en#single-table-inheritance

Single Table Inheritance
Single Table Inheritance is an inheritance mapping strategy where all classes of a hierarchy are mapped to a single database table. In order to distinguish which row represents which type in the hierarchy a so-called discriminator column is used.

External resource http://martinfowler.com/eaaCatalog/singleTableInheritance.html seems do be unavailable.

[DWEB-58] Missing parameter and semicolon for setMemcache() call

Sun, 5 Sep 2010 03:50:06 +0000

URL: http://www.doctrine-project.org/projects/orm/2.0/docs/reference/caching/en#cache-drivers:memcache

Documentation

<?php

$memcache = new Memcache();
$memcache->connect('memcache_host', 11211);

$cacheDriver = new \Doctrine\Common\Cache\MemcacheCache();
$cacheDriver->setMemcache()
$cacheDriver->save('cache_id', 'my_data');

Doctrine\Common\Cache\Memcache

class MemcacheCache extends AbstractCache
{
    /* ... */
    
    /**
     * Sets the memcache instance to use.
     *
     * @param Memcache $memcache
     */
    public function setMemcache(Memcache $memcache)
    {
        $this->_memcache = $memcache;
    }
    
    /* ... */
}

Pseudo Patch

<?php

$memcache = new Memcache();
$memcache->connect('memcache_host', 11211);

$cacheDriver = new \Doctrine\Common\Cache\MemcacheCache();
- $cacheDriver->setMemcache()
+ $cacheDriver->setMemcache($memcache);
$cacheDriver->save('cache_id', 'my_data');

[DWEB-57] Incorrect example for EntityGenerator

Thu, 2 Sep 2010 08:32:39 +0000

There is incorrect example in this page
http://www.doctrine-project.org/api/orm/2.0/doctrine/orm/tools/entitygenerator.html

Generic class used to generate PHP5 entity classes from ClassMetadataInfo instances
[php] $classes = $em->getClassMetadataFactory()->getAllMetadata();
$generator = new \Doctrine\ORM\Tools\EntityGenerator(); $generator->setGenerateAnnotations(true); $generator->setGenerateStubMethods(true); $generator->setRegenerateEntityIfExists(false); $generator->setUpdateEntityIfExists(true); $generator->generate($classes, '/path/to/generate/entities');

Fatal error: Call to undefined method Doctrine\ORM\EntityManager::getClassMetadataFactory()

[DWEB-56] Doctrine 2 - sample cli-config.php in "Getting Started XML-Edition" documentation is incorrect.

Mon, 23 Aug 2010 19:05:49 +0000

From this page: http://www.doctrine-project.org/projects/orm/2.0/docs/cookbook/getting-started-xml-edition/en

The contents of the sample cli-config.php file are:

<?php
$cliConfig = new Doctrine\Common\Cli\Configuration();
$cliConfig->setAttribute('em', $entityManager);

This generates an error: Fatal error: require(): Failed opening required 'Doctrine\Common\Cli\Configuration.php' as the class referenced does not exist.

Futhermore, having examined the $entityManager variable, it is not set and evaluates to NULL.

[DWEB-55] Missing datetimetz mapping type + one tiny typo

Tue, 3 Aug 2010 08:55:31 +0000

In section http://www.doctrine-project.org/projects/orm/2.0/docs/reference/basic-mapping/en#doctrine-mapping-types

mapping type datetimetz is missing
there is a tiny typo in definition of array type - there should be "to a PHP array" instead of "to a PHP object".

Jan

[DWEB-54] Doctrine 2 Documentation - Yaml Mapping

Wed, 1 Dec 2010 07:56:42 +0000

The current documentation for the Doctrine2 YAML Mapping ( found here: http://www.doctrine-project.org/projects/orm/2.0/docs/reference/yaml-mapping/en#yaml-mapping )

introduces a wrong format for the identifier colum specification.

I had to go dig around in the source code to find the correct format.
For anyone less persistent or not accustomed to check the source code of a library this would result in serious headache.

WRONG:
id:
id:
type: integer
generator:
strategy: AUTO

RIGHT: (at least with current trunk )
id:
type: integer
id: true
generator:
strategy: AUTO

[DWEB-53] ORM Sandbox Documentation Mini Tutorial 1st step has bug

Tue, 13 Jul 2010 23:10:16 +0000

Quick Start documentation for ORM has a bug

http://www.doctrine-project.org/projects/orm/2.0/docs/reference/introduction/en#sandbox-quickstart

The "Mini-tutorial" first step says to run

" php doctrine orm:schema-tool:create ./Entities "

but this results in the script saying:

[RuntimeException]
Too many arguments.

removing the ./Entities parameter seems to work fine and gets the response that the tutorial specifies.

[DWEB-52] Make note that Model generating will process all yml file given the yaml_schema_path configuration

Thu, 24 Jun 2010 10:47:54 +0000

Lik: http://groups.google.com/group/doctrine-user/browse_thread/thread/a33eb8a2e66c3e54

I would suggest to extend the documentation with the information that when you have multiple YAML files for generating Models in the folder according the actual configuration [ 'yaml_schema_path' ]. All this YAML files will be processed not only the schema.yml file as I assumed according the current documentation.

somewhere, somehow I got the info that you can lay out your YAML definition in multiple files but as there was no example / explanation of the howto I didn't gave much attention to it.

r. Sandor

[DWEB-51] Errors in DBAL schema manager reference

Tue, 8 Jun 2010 17:31:26 +0000

In the 3rd snippet of <http://www.doctrine-project.org/projects/dbal/2.0/docs/reference/schema-manager/en#createschema>, is missing a Doctrine\DBAL\Platforms\AbstractPlatform instance as the second parameter:

From:

<?php $sql = $fromSchema->getMigrateToSql($toSchema);

To:

<?php $sql = $fromSchema->getMigrateToSql($toSchema, $conn->getDatabasePlatform());

[DWEB-50] Errors in DBAL data and retrieval reference

Tue, 8 Jun 2010 17:30:11 +0000

I found some errors in this page <http://www.doctrine-project.org/projects/dbal/2.0/docs/reference/data-retrieval-and-manipulation/en>:

"execute($sql, array $params)" the method name is wrong. It should be "executeQuery"
the code snippet for "fetchColumn()" is wrong, the thirdy param should be long:

$username = $conn->fetchColumn('SELECT username FROM user WHERE id = ?', array(1), 0);

[DWEB-49] AddColumn prototype in Doctrine Migrations missing length parameter

Tue, 8 Jun 2010 17:24:41 +0000

The current prototype for AddColumn under Doctrine Migrations (http://www.doctrine-project.org/projects/orm/1.2/docs/manual/migrations/en#writing-migration-classes:available-operations:add-column) is incorrect.

It is missing the length parameter (param 4).

Currently contains:

$this->addColumn('table_name', 'column_name', 'string', $options);

Should show:
$this->addColumn('table_name', 'column_name', 'string', $length, $options);

[DWEB-48] phpdoctrine.org is down, My First Project links need to be updated

Tue, 8 Jun 2010 17:17:23 +0000

http://www.doctrine-project.org/projects/orm/1.2/docs/cookbook/my-first-project/ru#my-first-project

"To get started, first download the latest Doctrine sandbox package: http://www.phpdoctrine.org/download. Second, extract
the downloaded file and you should have a directory named Doctrine-x.x.x-Sandbox. Inside of that directory is a simple
example implementation of a Doctrine based web application."

http://www.phpdoctrine.org/download
redirects to
http://www.sayvings.com/download

[DWEB-47] Confusing PHP version information in Doctrine 2.0 docs

Tue, 8 Jun 2010 17:17:36 +0000

http://www.doctrine-project.org/projects/orm/2.0/docs/en

Mentions:

"Object relational mapper (ORM) for PHP 5.2.3+ and 5.3.0+ that sits on top of a powerful database abstraction layer (DBAL).".

Since this url is for 2.0, it may confuse users. I had a look at the doctrine-website source to see if I could work out where the problem may be, but symfony is beyond me, maybe a 5.2.3+ (Doctrine 1.2) and a 5.3.0+ (Doctrine 2) ?

[DWEB-46] Spam cleanup in JIRA

Tue, 8 Jun 2010 17:28:20 +0000

Some link spam needs to be removed.

See ~~DC-85~~ , ~~DC-298~~, and especially ~~DDC-143~~

[DWEB-45] Padding for pre/code blocks

Tue, 8 Jun 2010 17:13:57 +0000

http://www.doctrine-project.org/projects/orm/2.0/docs/reference/events/en#load-classmetadata-event

Alignment of the code blocks doesnt have any padding.

[DWEB-44] Documentation about NOT IN or <> ALL seems to be wrong

Fri, 7 May 2010 05:30:52 +0000

The ALL or ANY operators like presented in the documentation http://www.doctrine-project.org/documentation/manual/1_2/en/dql-doctrine-query-language#conditional-expressions:all-and-any-expressions seems to be not working.

I'm trying to use them but no way, I always get errors. For exemple if I do this query:

Doctrine_Query::create()
->from('Contact')
->where('Contact.id <> ALL (FROM Email(contact_id)')
->execute();

I get this error:
PHP Fatal error: Uncaught exception 'Doctrine_Exception' with message 'Couldn't find class Email(contact_id)'

Is there a problem in the documentation??

[DWEB-43] "User" contributed documentation has vanished

Tue, 8 Jun 2010 17:14:45 +0000

None of the documents on the following URL work any more

http://www.doctrine-project.org/documentation/user/1_2/en

Same for

http://www.doctrine-project.org/documentation/user/1_1/en

[DWEB-42] PEAR installation instructions incorrect

Tue, 8 Jun 2010 17:15:20 +0000

The PEAR installation instructions within the Doctrine 2.0 manual appear to be incorrect.

http://www.doctrine-project.org/documentation/manual/2_0/en/introduction#installing

The instructions refer to a channel at phpdoctrine.org, but that domain appears to be owned by a squatter or something. I was able to find pear.doctrine-project.org, but it appears that only the 1.x series is available through that PEAR channel.

So, all three of the suggested sudo pear install pear.phpdoc... lines appear to be invalid.

Also, a minor grammar note.. The following line (which is immediately after the three pear installation commands) seems like bad grammar to me:

When you have a package installed via PEAR you can required and load the ClassLoader with the following code.

I'd suggest maybe just "require" or simply remove "required and".

[DWEB-41] Approve pending registrations to the Google Group

Tue, 8 Jun 2010 16:54:13 +0000

Please approve pending registrations to the Google Group, or deploy a discussion system where users can self-register.

I've been waiting for almost two days now!

[DWEB-40] Doctrine manual not working

Tue, 13 Apr 2010 11:52:06 +0000

This link doesnt work http://www.doctrine-project.org/documentation/2_0/en

This is HTML of the page

  <ul id="breadcrumb_trail">
    <li><a class="cms_page_navigation" href="/">Home</a></li>
          <li>2.0 Documentation</li>
      </ul>




<div id="doc_index">
  <ul id="doc_left">

                            <li class="doc_box_row yellow">
<div class="doc_box" id="manual_doc_box">
          <a target="_BLANK" href="http://www.amazon.com/Doctrine-ORM-PHP-Jonathan-Wage/dp/2918390038/ref=sr_1_1?ie=UTF8&amp;s=books&amp;qid=1246303098&amp;sr=8-1"><img align="right" style="margin-left: 20px; margin-right: 20px;" src="/uploads/assets/cover_images/16f6fbd99672319b4d4135d73f712f47ea586759.png" /></a>  
    <h2><a href="http://www.doctrine-project.org/documentation/manual/2_0/en">Doctrine ORM for PHP</a></h2>
  <h5>Guide to Doctrine for PHP</h5>

  

<ul class="viewing_options">
    <li>

[DWEB-39] Typo in example in DQL documentation

Fri, 9 Apr 2010 15:44:28 +0000

http://www.doctrine-project.org/documentation/manual/1_2/en/dql-doctrine-query-language

Finding all articles which don't have readers:
// test.php

// ...
$q = Doctrine_Query::create()
->select('a.id')
->from('Article a')
->where('NOT EXISTS (SELECT r.id FROM ReaderLog r WHERE r.article_id = a.id));

echo $q->getSqlQuery();

There is missing apostrophe at the end of the where line.

[DWEB-38] Instruction to load generated models missing

Tue, 8 Jun 2010 17:23:20 +0000

Following the step-by-step instructions in the Doctrine guide yields an error after the step requesting

Doctrine_Core::loadModels('models');

be added to the bootstrap.php file. The error is that the base model class files cannot be found because they are in a subdirectory under models/ - models/generated/.

This issue can be fixed by adding:

Doctrine_Core::loadModels('models/generated');

to the bootstrap file BEFORE the loadModels that just loads the "models" directory, or alternatively by moving all the models in the generated directory to the parent directory "models".

[DWEB-37] Field Lazy Loading Documentation Issue

Tue, 8 Jun 2010 17:22:32 +0000

http://www.doctrine-project.org/documentation/manual/1_2/en/working-with-models

Under Field Lazy Loading, it reads:

The following lazy-loads the password field and executes one additional database query to retrieve the value:

// test.php

// ...
$user->description;

It seems to me that there is a mismatch between the field that is retrieved (description) and the wording ("lazy loads the password field").

[DWEB-36] Broken footer link

Tue, 8 Jun 2010 17:10:50 +0000

At the foot of the Doctrine 2 documentation there are the words:

"If you find a problem with the documentation or have a suggestion, please register and open a ticket. "

The word register points to a non-existent Trac page - I guess it's supposed to point to JIRA?

[DWEB-34] Ambiguous dates

Mon, 1 Mar 2010 16:40:16 +0000

Dates on the download page are ambiguous.
There are currently 3 listed - and as none happen to have a day value > 12 - It's not obvious which field is the month.
e.g
06/01/2011
02/01/2010
03/01/2010

Please use an internationally comprehensible date format such as iso8601

[DWEB-33] Pear/Doctrine Download Link not working

Wed, 10 Mar 2010 16:45:26 +0000

It looks like the pear channel for installing is down. This failed first:
> pear install pear.phpdoctrine.org/Doctrine-1.2.1.tgz
Attempting to discover channel "pear.phpdoctrine.org"...

Then this failed:
> pear channel-discover pear.phpdoctrine.org
Discovering channel pear.phpdoctrine.org over http:// failed with message: channel-add: Cannot open "http://pear.phpdoctrine.org/channel.xml" (Connection to `pear.phpdoctrine.org:80' failed: Operation timed out)
Trying to discover channel pear.phpdoctrine.org over https:// instead
Discovery of channel "pear.phpdoctrine.org" failed (channel-add: Cannot open "https://pear.phpdoctrine.org/channel.xml" (Connection to `pear.phpdoctrine.org:443' failed: Operation timed out))

And then I checked downforeveryoneorjustme.com and they said it's down for everyone. :/

[DWEB-32] update documentation & download links for Temporal 1.1

Mon, 1 Mar 2010 16:58:36 +0000

looks like the site updater is still broken... Wondering if we could do a manual push of both code & documentation for the 1.1 branch of the Temporal extension

[DWEB-31] Typo in Doctrine 1.2 Manual, chapter Data Hydrators

Mon, 1 Mar 2010 17:00:41 +0000

In the Doctrine 1.2 Manual, chapter 'Data Hydrators', paragraph 'Nested Set Array Hierarchy'
(http://www.doctrine-project.org/documentation/manual/1_2/en/data-hydrators#core-hydration-methods:nested-set-array-hierarchy)
A reference is made to the constant 'HYDRATE_ARRAY_RECORD', while this should be 'HYDRATE_RECORD_HIEARCHY'.

Full sentence:
"If you wish to hydrate the nested set hierarchy into arrays instead of objects you can do so using the HYDRATE_ARRAY_HIERARCHY constant. It is identical to the HYDRATE_ARRAY_RECORD except that it uses PHP arrays instead of objects."
Should be:
"If you wish to hydrate the nested set hierarchy into arrays instead of objects you can do so using the HYDRATE_ARRAY_HIERARCHY constant. It is identical to the HYDRATE_RECORD_HIERARCHY except that it uses PHP arrays instead of objects."

[DWEB-30] Doctrine website doc about module load missing line information

Tue, 8 Jun 2010 17:03:57 +0000

Using the website as a tutorial can cause issues with 1.2. The website documentation about registering the autoload is missing a line to work in 1.2.
http://www.doctrine-project.org/documentation/manual/1_2/1_2/getting-started#implementing:register-autoloader
is missing a reference to
http://www.doctrine-project.org/upgrade/1_2#Models Autoloading

Not sure if I am explaining this correctly but using the website as a guide to get started I got "Fatal error: Class 'BaseBlah' not found in /dir/models/Blah.php on line 13" and other assorted errors. It was not until someone in IRC to add that line into my bootstrap file that everything started working.

[DWEB-29] Installation instructions missing reference to registering 'modelsAutoload'

Tue, 8 Jun 2010 17:03:25 +0000

I was recently going through the Doctrine installation documentation as a refresher, and noticed that it doesn't seem to mention the requirement to add the following line to implement model autoloading. I ended up finding it via the upgrade instructions on http://www.doctrine-project.org/upgrade/1_2#Models%20Autoloading

spl_autoload_register(array('Doctrine', 'modelsAutoload'));

It seems like it would be useful to mention this on:
http://www.doctrine-project.org/documentation/manual/1_2/en/introduction-to-models#autoloading-models

And possibly on:
http://www.doctrine-project.org/documentation/manual/1_2/en/getting-started%3Aimplementing

[DWEB-28] Fix the links in the documentation site

Tue, 8 Jun 2010 17:32:13 +0000

When you are in http://www.doctrine-project.org/documentation/api/1_2 and tries to switch to the documentation for 2.0 an error occurs.

http://www.doctrine-project.org/documentation/api/2_0 (not found)

http://www.doctrine-project.org/documentation//en (not found)

[DWEB-27] In many-to-many documentation /deleting-a-link , say relation "GroupUser" and I think that the correct relation name is "UserGroup"

Mon, 1 Mar 2010 16:22:01 +0000

In many-to-many documentation /deleting-a-link , say relation "GroupUser" and I think that the correct relation name is "UserGroup"

http://www.doctrine-project.org/documentation/manual/1_2/en/working-with-models#many-to-many-relations:deleting-a-link

say..

+++++++++++++++++++++++++++++++++++++++++++++++++++++++

// test.php
// ...
$q = Doctrine_Query::create()
->delete('GroupUser') ---> SEE HERE !
->addWhere('user_id = ?', 5)
->whereIn('group_id', array(1, 2));

$deleted = $q->execute();
+++++++++++++++++++++++++++++++++++++++++++++++++++++++

and I think that the correct is

// test.php
// ...
$q = Doctrine_Query::create()
->delete('UserGroup') ---> SEE HERE !
->addWhere('user_id = ?', 5)
->whereIn('group_id', array(1, 2));

$deleted = $q->execute();

+++++++++++++++++++++++++++++++++++++++++++++++++++++++

I arrived this conclusion because in the same page ( http://www.doctrine-project.org/documentation/manual/1_2/en/working-with-models#define-test-schema ) , on top, defining model.
And the day spend seeing why my example don't work : ). Finaly I saw that in doctrine documentation 1.0 the relation was "GroupUser" but in this version, with this model defined is "UserGroup"

....
// models/UserGroup.php

class UserGroup extends Doctrine_Record --> The relation is defined with the name "UserGroup"
{
...

In the YAML format is the same name

UserGroup: --> "UserGroup"
columns:
user_id:

+++++++++++++++

Greetings, and Thanks for Doctrine, and apologice for my English.

[DWEB-26] "Report spam" functionality on comments

Tue, 8 Jun 2010 17:02:35 +0000

You know that there lot's of spam messages on your blog. At least here http://www.doctrine-project.org/blog/doctrine-1-2-1-released.
I think that you need to implement some "report spam" functionality in blog comments to keep it clean.

[DWEB-25] Searechable Query Langauge is undocumented

Tue, 19 Jan 2010 18:00:53 +0000

The documentation for the searchable is very light and doesn't explain much

http://www.doctrine-project.org/documentation/manual/1_1/hu/searching#query-language

[DWEB-24] CodeIgniter Info in Cookbook

Mon, 18 Jan 2010 04:39:19 +0000

The documentation on this page is where the error is:

http://www.doctrine-project.org/documentation/cookbook/1_0/en/code-igniter-and-doctrine

Two lines of code in the block for database.php is stated as follows:

// Require Doctrine.php
require_once(realpath(dirname(_FILE_) . '/../..') . DIRECTORY_SEPARATOR . 'database/doctrine/Doctrine.php');

It should be:

// Require Doctrine.php
require_once(BASEPATH . 'database/doctrine/Doctrine.php');

And the other line of code in database.php is stated as:

// Load the models for the autoloader
Doctrine::loadModels(realpath(dirname(_FILE_) . '/..') . DIRECTORY_SEPARATOR . 'models');

When it should be

// Load the models for the autoloader
Doctrine::loadModels(APPPATH . 'models');

Please edit this to use the CodeIgniter constants. I fixed them in my app because the info in your tutorial was wrong. This is because I ALWAYS separate my application directory and my system directory, and move them away from the web-accessible (htdocs) directory where my index.php resides.

Thanks!
Sean

[DWEB-23] Manual has wrong information and missing image

Mon, 1 Mar 2010 16:28:11 +0000

I'm going through the documentation on setting up Doctrine 1.2 and so far found 3 issues.

http://www.doctrine-project.org/documentation/manual/1_2/en/introduction#doctrine-explained
There is supposed to be an image but the image does not exist.

http://www.doctrine-project.org/documentation/manual/1_2/en/getting-started#installing:svn:installing
This gives the SVN path of http://svn.doctrine-project.org/branches/1.0 when it should be http://svn.doctrine-project.org/branches/1.2
It uses 1.0 a lot of times within this page. Because i downloaed 1.0 it didnt have the Core class and i had errors and couldnt figured it out. finally i figured it was not me but you gave me the wrong path.

After i found that last one, a pretty big error, i decided to submit a ticket. At the bottom of each page it says "If you find a problem with the documentation or have a suggestion, please register and open a ticket. " When i click "please register" it brings me to a page not found page, instead of bringing me here.

I didnt get past the getting started section of the documentation so i do not know if there is anything else, but i will let you know when i come across anything.

[DWEB-22] BBCode not closed so code not parsed

Mon, 1 Mar 2010 16:29:41 +0000

On the documentation page http://www.doctrine-project.org/documentation/manual/1_2/1_2/dql-doctrine-query-language in the button there is the following:
You can even mix the conditions.

[php]
$users = $userTable->findByIsAdminAndIsModeratorOrIsSuperAdmin(true, true, true);

It might be an issue due to the not closing tag [/php]. The PHP code is not parsed.

[DWEB-21] Relational Bounds Image not found on Documentation

Tue, 8 Jun 2010 17:19:42 +0000

On the page http://www.doctrine-project.org/documentation/manual/1_2/en/introduction the image Relationa Bounds (http://code-factory.org/doctrine-manual-images/relational-bounds.jpg) does not exist.

[DWEB-20] All documentation points to trac as Doctrine's issue tracker instead of JIRA

Mon, 1 Mar 2010 19:00:14 +0000

Meanly on documentation, whenever an issue must be reported the link points to Trac and not to JIRA.

[DWEB-19] Description of autoloading models not updated for version 1.2

Thu, 28 Oct 2010 16:26:33 +0000

In the section Introduction to Models/Autoloading Models it says that Doctrine_Core::autoload() will autoload the model. This isn't correct anymore in version 1.2. You have to use Doctrine_Core::modelsAutoload().

[DWEB-18] PDF version of the Doctrine 1.1 API Documentation is truncated

Mon, 1 Mar 2010 19:04:48 +0000

Hi there.

The pdf version of the Doctrine 1.1 API Documentation is truncated.

The pdf file I'm referring to is the one accessible here : http://www.doctrine-project.org/downloads/pdfs/api-1-1-en.pdf

Basically, the Table Of Contents of the document lists all of the content from the online api documentation accessible at http://www.doctrine-project.org/documentation/api/1_1 but most of the content listed has "0-page" references and the actual corresponding content is not in the document.

Regards

Robert Tome

[DWEB-17] Typo in NestedSet documentation

Mon, 7 Dec 2009 19:14:02 +0000

Hi Jon,

There is a small typo in the NestedSet chapter of the documentation here :

http://www.doctrine-project.org/documentation/manual/1_1/en/hierarchical-data#nested-set:advanced-usage:fetching-a-tree-with-relations

In the following code :

$q = Doctrine_Query::create();
    ->select('c.name, p.name, m.name')
    ->from('Category c')
    ->leftJoin('c.HottestProduct p')
    ->leftJoin('p.Manufacturer m');

There is an extra ";" character at the end of the Doctrine_Query::create() statement. It should be :

$q = Doctrine_Query::create()
    ->select('c.name, p.name, m.name')
    ->from('Category c')
    ->leftJoin('c.HottestProduct p')
    ->leftJoin('p.Manufacturer m');

Regards.

Hugo.

[DWEB-16] Typo in "Defining Models"

Wed, 18 Nov 2009 21:18:16 +0000

There is a wrong attribute name in "Many to Many" section and ` should be {{ or }} in newly added sections for 1.2.

1.2
~~$manager~~>setAttribute(Doctrine_Core::Doctrine_Core::ATTR_QUOTE_IDENTIFIERS, true);
+$manager->setAttribute(Doctrine_Core::ATTR_QUOTE_IDENTIFIERS, true);

1.1,1.0
~~$manager~~>setAttribute(Doctrine::Doctrine::ATTR_QUOTE_IDENTIFIERS, true);
+$manager->setAttribute(Doctrine::ATTR_QUOTE_IDENTIFIERS, true);

[DWEB-15] Incorrect grammer on intro to DQL

Wed, 18 Nov 2009 21:19:19 +0000

The introduction page to DQL ( http://www.doctrine-project.org/documentation/manual/1_1/en/dql-doctrine-query-language ) contains some poor grammer. Specifically this bullet point:

"DQL has some very complex built-in algorithms like (the record limit algorithm) which can help developer to efficiently retrieve
objects"

It should read something like this:

"DQL has some very complex built-in algorithms like the record limit algorithm, which can help the developer to efficiently retrieve
objects"

[DWEB-14] 'Searching" section is confusingly named.

Wed, 18 Nov 2009 21:21:54 +0000

There is a section of the documentation called "Searching". This is a misleading since the section is about full text searching. The first time I went to that section I was looking for more information on how to search for certain models based on normal column / attributes, the sort of thing "findBy*" does.

I suggest renaming that section to "Text Searching", "Full Text Search", "Full Text Searching", "Searching inside Models", "Searching Text", etc. as a way to clarify what the documentation in that section refers to.

The MySQL documentation even refers to it as "Full-Text Search Functions" ( http://dev.mysql.com/doc/refman/5.1/en/fulltext-search.html )

[DWEB-13] Many terms on the documentation website look like links, but aren't links

Wed, 18 Nov 2009 21:26:26 +0000

The Doctrine Book on the website has confusing style colours. Normal HTML hyperlinks are in blue and are not underlined. Non-HTML link text that looks like it should be a link is blue and not underlined. This will confuse the user (and indeed confused my greatly the first time I was reading the web page).

For example on the first page ( http://www.doctrine-project.org/documentation/manual/1_1/en/introduction ), the text towards the start "Pulled from Wikipedia:" has 'Wikipedia' in blue text and not underlined, it is a link to Wikipedia. Further down the page there is reference to various Doctrine classes and methods. This text is blue and not underlined. It is not a link.

However the normal user will assume that this are links because

(a) they look very similar to links on the same page

(b) the look similar to links on the rest of the internet (blue is a common colour, and it's not uncommon to find non-underlined links)

and (c) it's common in technical documentation to include links other parts of the documentation when you mention a function or class. e.g.: The PHP tutorial ( http://ie2.php.net/manual/en/tutorial.firstpage.php ) includes a 'echo()' function call and the text to 'echo' is a link to the function details for echo.

[DWEB-12] Documentation Website - Link to "Start Reading Introduction" is misleading

Mon, 30 Nov 2009 10:49:27 +0000

The doctrine documentation landing page ( http://www.doctrine-project.org/documentation ), has a link on the top left ish of the web page titled "Start Reading Introduction". This is a confusing titled link. It's actually a link to the first section of the Doctrine book, the Introduction. However to the first time visitor of this webpage, it looks like it's a link to an introduction to doctrine documention. As the user starts reading this page and the linked pages off it, they will get confused.

I suggest calling the link "Start Reading Doctrine Book", "Read online now", "Doctrine ORM for PHP" or similar.

[DWEB-11] documentationcould use some simple clarification

Wed, 18 Nov 2009 22:04:02 +0000

I'm completely new to Doctrine, trying to assemble a light-weight toolkit. (So if I'm posting things in the wrong places, I need to know that, too. Though the path from Home and Intro to posting is more baroque than necessary.)
I'm running xampp in XP. It's one of my preferred development environments.
In <a href="http://www.doctrine-project.org/documentation/manual/1_1/en/getting-started">Getting Started</a>, there are very detailed, line-by-line instructions for creating cascades of directories – without any overview or overall summary.
Specificly, <a href="http://www.doctrine-project.org/documentation/manual/1_1/en/getting-started#implementing">Implementing</a> says, "create a directory named doctrine_test," with no pathing, then says I "need to move the Doctrine libraries in to the doctrine_test directory into a folder in doctrine_test/lib/vendor/doctrine," without clarifying the final destination of "the Doctrine.php file containing the core class" or its correct path. This has given my installation unnecessary grief.

[DWEB-10] Documentation typo

Tue, 3 Nov 2009 20:38:12 +0000

http://www.doctrine-project.org/documentation/manual/1_1/en/event-listeners:record-listeners

change :
class Logger extends Doctrine_Overloadable

by
class Logger implements Doctrine_Overloadable

A copy paste of the documentation results to a fatal error
Fatal error: Class ************ cannot extend from interface Doctrine_Overloadable in ************ on line 2

[DWEB-9] The website still says bugs should be reported via Trac

Tue, 3 Nov 2009 20:43:56 +0000

The wiki still suggests to report bugs via Trac: http://trac.doctrine-project.org/wiki and http://trac.doctrine-project.org/wiki/ReportBug
This should be updated

[DWEB-8] Firefox search-engine addon for the Doctrine API

Tue, 3 Nov 2009 21:03:32 +0000

I have implemented a search-engine addon for Firefox for looking-up the API documentation of a Doctrine class. You simply type-in the name of a class and the API doc page for that class will be displayed.

The add-on is currently set-up to link to the 1.1 documentation.

You can download the addon from here: https://addons.mozilla.org/en-US/firefox/addon/45316

According to the docs at https://developer.mozilla.org/en/Creating_OpenSearch_plugins_for_Firefox#Autodiscovery_of_search_plugins you can "advertise [a search engine addon] so that Firefox users can easily download and install the plugin". All you need do is add a LINK element to the HEAD; something like the following.

Hope that's of some use. If so, would you mind if I replace my awful screenshot of the addon with a decent copy of the Doctrine logo, please?

I've enclosed the addon XML, should you be interested.

Best regards

[DWEB-7] 404 error in faq

Tue, 3 Nov 2009 20:55:03 +0000

You can submit a bug via our trac system. It is required that you register to submit a bug. It also is recommended that you write a failing test case for your issue, you can read about test cases here.

"here" is broken (it points to http://trac.phpdoctrine.org/wiki/TestCases)

I guess the URL should be:
http://www.doctrine-project.org/documentation/manual/1_1/en/unit-testing#writing-tests

[DWEB-6] found (what I believe to be) a minor error in the documentation (online and pdf)

Tue, 3 Nov 2009 20:57:28 +0000

pdf documentation version 1-1: pages 222-223

listing 13-42:
---
\# schema.yml
\# ...
User:
columns:
username:
type: string(255)
regexp: '/[a-zA-Z0-9]/'
\# ...

listing 13-43:
// test.php
// ...
$user = new User();
$user->username = '[jwage';
if ( ! $user->isValid()) {
echo 'User is invalid because the username contains a [ character';
}

is this correct?
or would the regex need to be: "/^[a-zA-Z0-9]+$/"

..seems that since the username "[jwage" contains at least one character in the set, it should match against the regex

..I probably shouldn't even ask.. being brand new to Doctrine. But it feels like a small documentation mistake when reading it. Thought I'd pass it along to someone who knows better. Thanks.

[DWEB-5] Typo on dealing with model relations page

Tue, 3 Nov 2009 20:58:35 +0000

Following text:

Lets say we have once again Users and Phonenmbers with their relation being one-to-many.

Should be:

Lets say we have once again Users and Phonenumbers with their relation being one-to-many.

[DWEB-4] Formatting does not work when creating a new issue

Tue, 13 Oct 2009 04:40:20 +0000

Formatting is not applied to descriptions when posting a new issue.

strong should create bold text (according to help, right of the description textarea). The example creates strong in the posted output.
The description is not being parsed for formatting. This should be fixed or the documentation changed.

EDIT: OK, that seems to have worked, but it doesn't always (example issue ~~DDC-29~~). I tried to format the changed code to appear bold and italicized to make finding the changes easier. This did not work.

Example:

_* else if ($param->isArray())
{
$parameterString .= 'array ';
} *_

This should appear bold and italic.

[DWEB-3] links to next/previous manual chapters are corrupted

Tue, 3 Nov 2009 20:36:09 +0000

Steps to reproduce:
1. Visit Creating Behaviors

Expected result:
There should be links at bottom of chapter text that lead to Delegate Methods and Core Behaviors accordingly.

What do we have now:
1. Leftside link to previous chapter is missing at all
2. Link to next chapter at right side leads to Query Language in Searching chapter

[DWEB-2] User contributed documentation contents are empty

Thu, 24 Sep 2009 14:58:37 +0000

All the three user contributed documentations have empty content, both in the website version and the PDF. There is no text, no table of contents etc. - just a blank page.

[DWEB-1] Language for documentations links does not appear to be consistent on http://www.doctrine-project.org/

Thu, 24 Sep 2009 15:15:00 +0000

The links presented to the online documentation on http://www.doctrine-project.org/ do not appear to be consistent with regard to language. For example, I am being presented with http://www.doctrine-project.org/documentation/manual/1_1/ru/introduction, which would imply Russian and not English (though the site displays in English like I expect it to anyways). Roman (romanb) also noticed some inconsistencies:

From IRC (I've removed irrelevant parts of the IRC chat to ease readability):

<subzero2000> Question regarding the following URL from the documentation: http://www.doctrine-project.org/documentation/manual/1_1/ru/configuration#identifier-quoting after manual/1_1, what does the ru signify?
...
<romanb> the language? but as there is no russian translation yet, it falls back to english I suppose
...
<subzero2000> I'm curious if it's language, because that would imply to me Russian, which I neither read, write, or speak at all. I just happened to notice it, and was wondering why it seems to be defaulting to ru with no apparent way to select the language, if that's what it is?
...
<subzero2000> If that's a web site "problem", is there a way of opening bugs for it, as I don't really think the default should be Russian (no offense to any of our Russian friends is intended).
...
<subzero2000> And by changing ru to en, the documentation on the site still renders properly, so I assume it's a language switch of some sort.
...
<romanb> subzero2000, for me the default for the documentation seems to be different. for 1.0 it is ru, for 1.1 en, for 1.2 ru and for 2.0 en. pretty strange
<subzero2000> romanb: Want me to see if I can open a bug for it in Trac?
<romanb> I think its not even consistent as I click around it changes every now and then
<romanb> subzero2000, http://doctrine-project.org/jira
<subzero2000> I didn't try the different versions, but for me 1.1 seems to default to wanting to use ru, and not en.

While I've not personally tested this, it appears to affect documentation for all versions, and as such also affects Doctrine 2 as well.