Download the PHP package robier/mock-global-php-functions without Composer
On this page you can find all versions of the php package robier/mock-global-php-functions. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package mock-global-php-functions
Mock global php functions
This library allows you to mock any global PHP functions to return predefined values.
This library was created after I saw implementation of Symfony's ClockMock component for mocking PHP native functions related to time. I was curious how to make a mechanism for mocking any PHP global function, so I created this small library.
This is achieved by PHP's namespace fallback policy:
PHP will fall back to global functions […] if a namespaced function […] does not exist.
Library uses mentioned feature to dynamically create namespaced function. For this library to work your code that you are testing should be in non global namespace context and call function unqualified. For example:
Known limitations
- Only unqualified function calls in a namespace context can be mocked. For example a call for
time()in the namespacefoois mockable, a call for\time()is not. - The mock has to be defined before the first call to the unqualified function in the tested class. This is documented in Bug #68541. In most cases, you can ignore this limitation as you only need to define a mock before any testing in your tests. It's also recommend that you run your tests as isolated process.
Api
At the moment there are 2 mocking objects that developers can use:
MockFunction- mock any given function with your own anonymous functionFreezeClock- mock time/sleep/date related functions, so they are in sync
MockFunction
Object that can mock any function from global namespace. Mock is active as long as magic method __destruct
is not called on that mock, or it's disabled manually via disable method. In that way you do not need to manually turn off mock
while writing tests, because as soon as current scope exists, mock is disabled, and you have clean slate.
Note: When creating mock use static callback instead of regular one. This prevents them from having the current class automatically bound to them.
Example:
Example of mocking sleep function:
FreezeClock
Handy object that can freeze time in given namespace.
Handy factory methods:
atZero- stops time at timestamp 0atTime- stops time at provided timeatMicrotime- stops time at provided microtimeatNow- stops at current time
Functions affected:
date- returns freeze formatted timetime- return freeze timemicrotime- return freeze microtimesleep- increase freeze time and it's not blocking like regular sleep functionusleep- increase freeze time and it's not blocking like regular usleep function
Tests
First run docker/build to build a container and then docker/run composer run test for running all tests.
Contribution
Feel free to contribute!
