From:             phpbug at elitecoders dot com
Operating system: Irrelevant
PHP version:      Irrelevant
PHP Bug Type:     Documentation problem
Bug description:  DOM documentation improvement

Description:
------------
I've been using PHP's DOM (both dom and domxml) for over a year and 
it's only today after a lot of research I've realized that because PHP 
uses libxml, and libxml uses UTF-8 internally that I have some serious 
issues with character encoding because of being ignorant of this.


I'm strongly suggesting a large note near the beginning of the DOM 
pages where knowing this information would be useful. In addition to 
the note, it might also be a good idea to link users to http://
xmlsoft.org/encoding.html where it goes over the whole utf8 thing and 
why they use it and blah blah blah.


Definitely a very visible note should be added here:
http://www.php.net/manual/en/ref.dom.php

On http://www.php.net/manual/en/function.dom-domdocument-construct.php
"The encoding of the document as part of the XML declaration." Here, 
it should be clarified that if you pass a character encoding, it does 
not affect the internal character encoding and you still need to 
utf8_encode characters outside of the normal ASCII range.


On http://www.php.net/manual/en/function.dom-domelement-construct.php 
and http://www.php.net/manual/en/function.dom-domtext-construct.php it 
needs to at least warn that characters outside of normal ascii need to 
be utf8 encoded.

I'm sure there are other pages as well, I need to get going though.

Reproduce code:
---------------
Not applicable

Expected result:
----------------
Not applicable

Actual result:
--------------
Not applicable

-- 
Edit bug report at http://bugs.php.net/?id=41000&edit=1
-- 
Try a CVS snapshot (PHP 4.4): 
http://bugs.php.net/fix.php?id=41000&r=trysnapshot44
Try a CVS snapshot (PHP 5.2): 
http://bugs.php.net/fix.php?id=41000&r=trysnapshot52
Try a CVS snapshot (PHP 6.0): 
http://bugs.php.net/fix.php?id=41000&r=trysnapshot60
Fixed in CVS:                 http://bugs.php.net/fix.php?id=41000&r=fixedcvs
Fixed in release:             
http://bugs.php.net/fix.php?id=41000&r=alreadyfixed
Need backtrace:               http://bugs.php.net/fix.php?id=41000&r=needtrace
Need Reproduce Script:        http://bugs.php.net/fix.php?id=41000&r=needscript
Try newer version:            http://bugs.php.net/fix.php?id=41000&r=oldversion
Not developer issue:          http://bugs.php.net/fix.php?id=41000&r=support
Expected behavior:            http://bugs.php.net/fix.php?id=41000&r=notwrong
Not enough info:              
http://bugs.php.net/fix.php?id=41000&r=notenoughinfo
Submitted twice:              
http://bugs.php.net/fix.php?id=41000&r=submittedtwice
register_globals:             http://bugs.php.net/fix.php?id=41000&r=globals
PHP 3 support discontinued:   http://bugs.php.net/fix.php?id=41000&r=php3
Daylight Savings:             http://bugs.php.net/fix.php?id=41000&r=dst
IIS Stability:                http://bugs.php.net/fix.php?id=41000&r=isapi
Install GNU Sed:              http://bugs.php.net/fix.php?id=41000&r=gnused
Floating point limitations:   http://bugs.php.net/fix.php?id=41000&r=float
No Zend Extensions:           http://bugs.php.net/fix.php?id=41000&r=nozend
MySQL Configuration Error:    http://bugs.php.net/fix.php?id=41000&r=mysqlcfg

Reply via email to