Download the PHP package winbox/args without Composer
On this page you can find all versions of the php package winbox/args. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package args
Short Description Windows command-line formatter
License MIT
Homepage http://github.com/johnstevenson/winbox-args
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 args
Winbox-Args
A PHP function to escape command-line arguments, which replaces escapeshellarg with more robust methods for both Windows and non-Windows platforms. Install from Packagist and use it like this:
Alternatively, you can just copy the code into your own project (but please keep the license attribution and documentation link).
What it does on the Windows platform
The following transformations are made:
- Double-quotes are escaped with a backslash, with any preceeding backslashes doubled up.
- The argument is only enclosed in double-quotes if it contains whitespace or is empty.
- Trailing backslashes are doubled up if the argument is enclosed in double-quotes.
See How Windows parses the command-line if you would like to know why.
By default, cmd.exe meta characters are also escaped:
- by caret-escaping the transformed argument (if it contains internal double-quotes or
%...%syntax). - or by enclosing the argument in double-quotes.
There are some limitations:
- If cmd is started with DelayedExpansion enabled,
!...!syntax could expand environment variables. - If the program name requires caret-escaping and contains whitespace, cmd will not recognize it.
- If an argument contain a newline
\ncharacter, this will not be escaped.
See How cmd.exe parses a command and Implementing a solution for more information.
What it does on non-Windows platforms
The argument is enclosed is single-quotes, with internal single-quotes escaped.
Is that it?
Yup. An entire repo for a tiny function. However, it needs quite a lot of explanation because:
- the command-line parsing rules in Windows are not immediately obvious.
- PHP generally uses cmd.exe to execute programs and this applies a different set of rules.
- there is no simple solution.
Full details explaining the different parsing rules, potential pitfalls and limitations can be found in the Wiki.
License
Winbox-Args is licensed under the MIT License - see the LICENSE file for details.
