doc:todo:undocumented

This is an old revision of the document!


Undocumented stuff

Feel free to document anything presented here. Entries linking to user notes have not been confirmed, so may or may not need documentations (or demonstrate real bugs) but they are worth exploring.

PHP 6

  • Binary and unicode string
<?php
 
$unicode = '傀傂两亨乄了乆刄';
$binary  = b'傀傂两亨乄了乆刄';
$binary2 = (binary) $unicode;
$binary3 = b<<<FOO
傀傂两亨乄了乆刄
FOO;
 
echo strlen($unicode);
echo strlen($binary);
echo strlen($binary2);
echo strlen($binary3);
 
?>
  • Unicode escapes
<?php 
 
// '\Uxxxxxx' 
$str = 'U+123: \U000123'; 
// '\uxxxx' 
$str = 'U+123: \u0123'; 
// unicode(8) "U+123: ģ"
var_dump($str);
 
?>
  • Normalization
<?php
 
$GLOBALS["\u212B"] = ' 승인 ';
// U+00C5 = Å
echo $GLOBALS["\u00C5"];
 
?>

PHP 5.3

  • SPL classes: ArrayObject, CachingIterator, RecursiveCachingIterator, DirectoryIterator, FilterIterator, LimitIterator, ParentIterator, RecursiveDirectoryIterator, RecursiveIteratorIterator, SimpleXMLIterator
  • goto
<?php 
 
goto a;
print 'Foo';
 
a:
print 'Bar';
 
?>
  • ?: operator
<?php 
 
var_dump(0 ?: 'Hello!'); // string(6) "Hello!"
 
?>
  • namespace:: (alternative for __NAMESPACE__)
<?php 
 
namespace foo::bar;
 
const bar = 2;
 
function foo() {
    return 'foo!';    
}
 
var_dump(namespace::bar, namespace::foo());
/*
int(2)
string(4) "foo!"
*/
?>
  • Override existing classes
<?php
 
namespace test;
 
class foo { }
 
use test::foo as stdClass;
 
var_dump(new stdClass);
/*
object(test::foo)#1 (0) {
}
*/
?>
  • new static;
<?php
 
class bar {
	public function show() {
		var_dump(new static);
	}
}
 
class foo extends bar {
	public function test() {
		parent::show();
	}
}
 
$foo = new foo;
$foo->test();
$foo::test();
/*
object(foo)#2 (0) {
}
object(bar)#2 (0) {
}
*/
?>
  • class_alias() function
<?php
 
class foo { }
class_alias('foo', 'bar');
 
var_dump(new bar);
/*
object(foo)#1 (0) {
}
*/
 
?>
  • Heredoc with double quotes
<?php
 
print <<<"FOO"
	Foobar! :)
FOO;
 
?>
  • user_ini.filename user-initialization mechanism and config variables:

user_ini.filename and user_ini.cache_ttl.

  • [HOST=] and [PATH=] configuration sections in php.ini
  • E_DEPRECATED
  • zend_parse_parameters types: C, f, Z, h
  • Closures

PHP 5.x

  • Type hints: self, parent and interfaces.
<?php 
 
interface iTest { }
 
class baz implements iTest {}
 
class bar { }
 
class foo extends bar {
    public function testFoo(self $obj) {
        var_dump($obj);
    }
    public function testBar(parent $obj) {
        var_dump($obj);
    }
    public function testBaz(iTest $obj) {
        var_dump($obj);
    }
}
 
$foo = new foo;
$foo->testFoo(new foo);
$foo->testBar(new bar);
$foo->testBaz(new baz);
$foo->testFoo(new stdClass); // Catchable fatal error
 
?>
  • “Illegal” property name.
<?php
 
$foo = new stdClass;
 
$foo->{'foo-bar'} = 'foo!';
 
var_dump($foo);
/*
object(stdClass)#1 (1) {
  ["foo-bar"]=>
  string(4) "foo!"
}
*/
?>

Others

  • case foo: accepts also case foo;
<?php 
 
switch (1) {
    case 0;
        print 'Zero!'; 
        break;
    case 1;
        print 'One!';
        break;
    default;
        print 'Other...';
}
 
?>
  • each() works with objects too, althrough return weird and known result. (bug report)
  • Trick for access private properties. (Article)
<?php
 
class foo {
    private $bar = 42;
 
}
 
$obj = new foo;
$propname="\0foo\0bar";
$a = (array) $obj;
echo $a[$propname];
 
?>
  • $arr[] is allowed when passed by reference
<?php
 
function test(&$var) { }
 
$arr = array();
test($arr[]);
 
?>

Add example

  • language.oop5.patterns: Add more patterns example?
  • function.xmlreader-isvalid: Add example.
  • function.dba-open: Suggested example. (note)
  • Heredoc in arguments.
<?php 
 
var_dump(array(<<<EOD
foobar! 
EOD
));
 
?>

Add Reference

  • odbc_exec() - Missing information about $flags (last parameter).
  • mb_ereg_search_init - Missing list of options. (php-src/ext/mbstring/oniguruma/doc/API)

User Requests

Add INSTALL Information

  • fileinfo.installation: “How to install fileinfo on Win32 (and Linux for that matter” (note)
  • enchant: How to install enchant.
  • filter: No longer (really) in PECL, so clarify this.
  • Windows: There is a related TODO item here

Errors/Aditional informations

  • mysqli-autocommit: “autocommit not only turns on/off transactions, but will also 'commit' any waiting queries.” (note)
  • mysqli-report: “are sent through an exception named 'mysqli_sql_exception' instead of a normal PHP warning.” (note)
  • pdf-begin-document: “doesn't seem to be much documentation on setting options with this function, ... some basic things:” (note)
  • function.curl-init: “has undefined behavior if you pass 'false'” (note)
  • function.dio-stat: “This extension is only available on Windows Platforms as of PHP 5.0.0” (note)
  • function.ctype-space: “ctype_space('') i.e. the empty string, returns true” (note)
  • ref.pdo: Example#5: “We must change the last two lines to catch the error ...” (note)
  • function.xmlwriter-write-element: “The second argument ($content) is actually not optional...” (note)
  • function.get-cfg-var: “It seems that this function doesn't work on Unix Operating Systems.” (note)
  • function.socket-read: “On non-blocking connections it may not return full length requested.” (note)
  • function.imagickdraw-setfillalpha: “setFillAlpha is deprecated use the replacement: setFillOpacity” (note)
  • function.disk-free-space: “Note that disk_free_space() does an open_basedir check.” (note)
  • function.imagick-trimimage: “This method requires ImageMagick version >= 6.2.8” (note)
  • ref.soap: “Do NOT use associative arrays or arrays not starting with element number 0...” (note)
  • function.Memcache-delete: “Memcache::delete() does not return FALSE on failure, but seems to return FALSE when there is no object in cache with the specified key.”
  • migration5.incompatible: “As with array_merge(), array_merge_recursive() returns NULL in PHP 5 if a non-array parameter is passed to it.” (note)
  • function.version-compare: “It should be noted that version_compare() considers 1 < 1.0 < 1.0.0 etc.” (note)
  • function.serialize: “serialize() will trim() any strings!” (note)
  • function.mcal-delete-event: Current usage is: mcal_delete_event($stream [, $eventid] ); (user note)
  • function.mcal-fetch-event: “Contrary to what the manual says, the End Date for recurance is not datetime recur_endate, it's object recur_enddate” (user note)
  • function.odbc-commit: When used within an odbc_fetch_row() loop, your selected set is lost. (user note)
  • function.ftp-nlist: You can do a wildcard file listing with ftp_nlist (note)
  • function.ftp-rawlist: the second parameter accepts also standard arguments of /bin/ls command like “-l” or “-t” (note)
  • function.curl-getinfo: “There is a constant missing from that list. CURLINFO_REDIRECT_COUNT will give you the number of redirects it went through if CURLOPT_FOLLOWLOCATION was set.” (note)
  • function.shell-exec: “If the return is empty, then command could not be executed or executed command returned an error.” (note)
  • tokens: “Undocumented constants/syntax/reference” (note)
doc/todo/undocumented.1219044401.txt.gz · Last modified: 2017/09/22 13:28 (external edit)