Page Menu
Home
WickedGov Phorge
Search
Configure Global Search
Log In
Files
F7402439
README.md
No One
Temporary
Actions
View File
Edit File
Delete File
View Transforms
Subscribe
Flag For Later
Award Token
Size
3 KB
Referenced Files
None
Subscribers
None
README.md
View Options
Wikimedia
ObjectFactory
=======================
Construct
objects
from
configuration
instructions
.
It
can
be
used
statically
,
or
as
a
service
wrapping
a
PSR
-
11
service
container
for
lazy
instantiation
of
objects
with
dependency
injection
.
Specification
array
-------------------
Contents
of
the
specification
array
are
as
follows
:
'
factory
'
=>
callable
,
'
class
'
=>
string
,
The
specification
array
must
contain
either
a
'
class
'
key
with
string
value
that
specifies
the
class
name
to
instantiate
or
a
'
factory
'
key
with
a
callable
(
is_callable
()
===
true
).
If
both
are
passed
,
'
factory
'
takes
precedence
but
an
InvalidArgumentException
will
be
thrown
if
the
resulting
object
is
not
an
instance
of
the
named
class
.
'
args
'
=>
array
,
'
closure_expansion
'
=>
bool
,
// default true
'
spec_is_arg
'
=>
bool
,
// default false
'
services
'
=>
(
string
|
null
)[],
// default empty
'
optional_services
'
=>
(
string
|
null
)[],
// default empty
The
'
args
'
key
,
if
provided
,
specifies
arguments
to
pass
to
the
constructor
/
callable
.
Values
in
'
args
'
which
are
Closure
instances
will
be
expanded
by
invoking
them
with
no
arguments
before
passing
the
resulting
value
on
to
the
constructor
/
callable
.
This
can
be
used
to
pass
live
objects
to
the
constructor
/
callable
.
This
behavior
can
be
suppressed
by
adding
closure_expansion
=>
false
to
the
specification
.
If
'
spec_is_arg
'
=>
true
is
in
the
specification
,
'
args
'
is
ignored
.
The
entire
spec
array
is
passed
to
the
constructor
/
callable
instead
.
If
'
services
'
is
supplied
and
non
-
empty
(
and
a
service
container
is
available
),
the
named
services
are
requested
from
the
PSR
-
11
service
container
and
prepended
before
'
args
'
.
`
null
`
values
in
'
services
'
are
passed
to
the
constructor
unchanged
.
Optional
services
declared
via
'
optional_services
'
are
handled
the
same
,
except
that
if
the
service
is
not
available
from
the
service
container
`
null
`
is
passed
as
a
parameter
instead
.
Optional
services
are
appended
directly
after
the
normal
required
services
If
any
extra
arguments
are
passed
in
the
options
to
getObjectFromSpec
()
or
createObject
(),
these
are
prepended
before
the
'
services
'
and
'
args
'
.
These
are
passed
using
the
`
extraArgs
`
key
,
and
any
Closure
instances
that
are
included
this
way
are
never
expanded
,
regardless
of
whether
the
main
argument
list
is
expanded
.
'
calls
'
=>
array
The
specification
may
also
contain
a
'
calls
'
key
that
describes
method
calls
to
make
on
the
newly
created
object
before
returning
it
.
This
pattern
is
often
known
as
"setter injection"
.
The
value
of
this
key
is
expected
to
be
an
associative
array
with
method
names
as
keys
and
argument
lists
as
values
.
The
argument
list
will
be
expanded
(
or
not
)
in
the
same
way
as
the
'
args
'
key
for
the
main
object
.
Note
these
calls
are
not
passed
the
extra
arguments
.
Installation
------------
```
$
composer
require
wikimedia
/
object
-
factory
```
Usage
-----
```
php
<?
php
$
specs
=
[
// Simple constructor based injection
'
testDB
'
=>
[
'
class
'
=>
PDO
::
class
,
'
args
'
=>
[
'
mysql
:
dbname
=
testdb
;
host
=
127.0
.
0.1
'
,
'
dbuser
'
,
'
dbpass
'
,
],
],
];
$
db
=
ObjectFactory
::
getObjectFromSpec
(
$
specs
[
'
testDB
'
]
):
```
License
-------
Wikimedia
ObjectFactory
is
licensed
under
the
GNU
General
Public
License
,
version
2
and
any
later
version
(
GPL
-
2.0
-
or
-
later
).
See
the
[
`
COPYING
`
](
COPYING
)
file
for
more
details
.
File Metadata
Details
Attached
Mime Type
text/plain
Expires
Sat, Nov 21, 18:03 (18 h, 10 m)
Storage Engine
local-disk
Storage Format
Raw Data
Storage Handle
86/f4/bfd2995f240ea0fc774bac9d9c41
Default Alt Text
README.md (3 KB)
Attached To
Mode
rMWPROD MediaWiki Production
Attached
Detach File
Event Timeline
Log In to Comment