Map-based autoloader across php and phar resources

⌈⌋ branch:  Canonic Autoloader


Check-in [c956af642c]

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
SHA1 Hash:c956af642cc9065ed3717baa15c6e63cba17d124
Date: 2015-01-22 19:34:07
User: mario
Comment:Typos in manpage.
Tags And Properties
  • branch=trunk inherited from [874e5b435b]
  • sym-trunk inherited from [874e5b435b]
Context
2015-01-22
19:34
[03d1a4e914] Prepare 0.3.4 step release. (user: mario, tags: trunk)
19:34
[c956af642c] Typos in manpage. (user: mario, tags: trunk)
19:33
[35d87d3c07] Introduce addPhar(), fix "const" subarray, keep static list of $instances. (user: mario, tags: trunk)
Changes

Changes to manpage.1.

12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
..
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67



68
69
70
71
72
73
74
.B *.php
scripts and
.B *.phar
collections. It self-contains the generated class map and
all updating logic.
.P
.VS
On invocation it scans the directories beneath its location.
The primary installation in
.I /usr/share/php
thus all globally shared includes.
.P
.I Not impemented:
future versions will allow to specify a list of directories
as arguments to include in the scanning process. Hereby
.IR ./ relative
path names will be kept relative to 
.B shared.phar
itself. While absolute
.IR / paths
................................................................................
.SH PHP USAGE
Activating the autoloader within PHP applications is as simple as calling
.IP 
.BR include_once (
.I """shared.phar""
.RB ) ;
.P
Which will implictly load the contained classmap.
.SH MANUAL UPDATES
If there's no binfmt registered for .phar files, then the php interpreter
must be prefixed for invoking the update mechanism:
.IP
.IB "php " "-d" "phar.readonly" "=" "0 " ./shared.phar
.P
.SH ENVIRONMENT
Recognized environment variables (as set via
.IB ".htaccess " SetEnv
for instance) in webserver or CLI context.
.TP
.BR AUTOLOADER_UPDATE " (boolean)"
Will enable implicit classmap updates on missed identifier (class)
lookups. Advisable for development setups only.



.SH PHP.INI SETTINGS
.TP
.IR phar.readonly " (boolean)"
Needs to be set to
.I 0
to allow updating of phars.
.SH FORMAT







|
|
<


|







 







|







<
<
<

|

|
>
>
>







12
13
14
15
16
17
18
19
20

21
22
23
24
25
26
27
28
29
30
..
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59



60
61
62
63
64
65
66
67
68
69
70
71
72
73
.B *.php
scripts and
.B *.phar
collections. It self-contains the generated class map and
all updating logic.
.P
.VS
On invocation from the command line it scans the directories
beneath its location. The primary installation in /usr/share/php

thus all globally shared includes.
.P
\fBNot implemented:\fR
future versions will allow to specify a list of directories
as arguments to include in the scanning process. Hereby
.IR ./ relative
path names will be kept relative to 
.B shared.phar
itself. While absolute
.IR / paths
................................................................................
.SH PHP USAGE
Activating the autoloader within PHP applications is as simple as calling
.IP 
.BR include_once (
.I """shared.phar""
.RB ) ;
.P
Which will implicitly activate the contained classmap.
.SH MANUAL UPDATES
If there's no binfmt registered for .phar files, then the php interpreter
must be prefixed for invoking the update mechanism:
.IP
.IB "php " "-d" "phar.readonly" "=" "0 " ./shared.phar
.P
.SH ENVIRONMENT



.TP
.IR AUTOLOADER_UPDATE " (boolean)"
Will enable implicit classmap updates on missed identifier (class)
lookups when run in webserver context. Advisable for development setups.
Best set via
.IB ".htaccess " SetEnv
or in VirtualHost section.
.SH PHP.INI SETTINGS
.TP
.IR phar.readonly " (boolean)"
Needs to be set to
.I 0
to allow updating of phars.
.SH FORMAT