plugin-php：漂亮PHP插件_php_HTML_其他

<div align="center"> <img alt="Prettier" src="https://raw.githubusercontent.com/prettier/prettier-logo/master/images/prettier-icon-light.png"> <img alt="PHP" height="180" hspace="25" vspace="15" src="https://upload.wikimedia.org/wikipedia/commons/thumb/2/27/PHP-logo.svg/500px-PHP-logo.svg.png"> </div> <h2 align="center">Prettier PHP Plugin</h2> <p align="center"> <a href="https://github.com/prettier/plugin-php/actions" rel='nofollow' onclick='return false;'> <img alt="GitHub Workflow Status" src="https://img.shields.io/github/workflow/status/prettier/plugin-php/Node CI?style=flat-square"> </a> <a href="https://www.npmjs.com/package/@prettier/plugin-php" rel='nofollow' onclick='return false;'> <img alt="npm version" src="https://img.shields.io/npm/v/@prettier/plugin-php.svg?style=flat-square"> </a> <a href="https://codecov.io/gh/prettier/plugin-php" rel='nofollow' onclick='return false;'> <img alt="Codecov Coverage Status" src="https://img.shields.io/codecov/c/github/prettier/plugin-php.svg?style=flat-square"> </a>  <a href="#badge" rel='nofollow' onclick='return false;'> <img alt="code style: prettier" src="https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square"> </a> <a href="https://gitter.im/jlongster/prettier" rel='nofollow' onclick='return false;'> <img alt="Gitter" src="https://img.shields.io/gitter/room/jlongster/prettier.svg?style=flat-square"> </a> <a href="https://twitter.com/PrettierCode" rel='nofollow' onclick='return false;'> <img alt="Follow+Prettier+on+Twitter" src="https://img.shields.io/twitter/follow/prettiercode.svg?label=follow+prettier&style=flat-square"> </a> </p> ## Intro Prettier is an opinionated code formatter. It enforces a consistent style by parsing your code and re-printing it with its own rules that take the maximum line length into account, wrapping code when necessary. This plugin adds support for the PHP language to Prettier. ### Can this be used in production? We're considering the plugin to be stable when pure PHP files are formatted. Formatting of files that contain mixed PHP and HTML is still considered unstable - please see [open issues with the tag "inline"](https://github.com/prettier/plugin-php/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Ainline) for details. If you want to use the plugin in production, we recommend limiting its scope to pure PHP files. ### Input ```php array_map(function($arg1,$arg2) use ( $var1, $var2 ) { return $arg1+$arg2/($var+$var2); }, array("complex"=>"code","with"=> function() {return "inconsistent";} ,"formatting"=>"is", "hard" => "to", "maintain"=>true)); ``` ### Output ```php array_map( function ($arg1, $arg2) use ($var1, $var2) { return $arg1 + $arg2 / ($var + $var2); }, [ "complex" => "code", "with" => function () { return "inconsistent"; }, "formatting" => "is", "hard" => "to", "maintain" => true, ] ); ``` ## Playground You can give the plugin a try in our [playground](https://loilo.github.io/prettier-php-playground/)! ## Install yarn: ```bash yarn add --dev prettier @prettier/plugin-php # or globally yarn global add prettier @prettier/plugin-php ``` npm: ```bash npm install --save-dev prettier @prettier/plugin-php # or globally npm install --global prettier @prettier/plugin-php ``` ## Use ### With Node.js If you installed prettier as a local dependency, you can add prettier as a script in your `package.json`, ```json { "scripts": { "prettier": "prettier" } } ``` and then run it via ```bash yarn run prettier path/to/file.php --write # or npm run prettier -- path/to/file.php --write ``` If you installed globally, run ```bash prettier path/to/file.php --write ``` ### In the Browser This package exposes a `standalone.js` that can be used alongside Prettier's own `standalone.js` to make the PHP plugin work in browsers without a compile step. First, grab both standalone scripts from an npm CDN like [unpkg](https://unpkg.com/): ```html <script src="https://unpkg.com/prettier/standalone.js"></script> <script src="https://unpkg.com/@prettier/plugin-php/standalone.js"></script> ``` Then use Prettier with PHP, just like this: ```js prettier.format(YOUR_CODE, { plugins: prettierPlugins, parser: "php" }); ``` See this code in action [in this basic demo](https://jsbin.com/butoruw/edit?html,output). ### With Bundlers Bundlers like webpack, Rollup or browserify automatically recognize how to handle the PHP plugin. Remember that even when using a bundler, you still have to use the standalone builds: ```js import prettier from "prettier/standalone"; import phpPlugin from "@prettier/plugin-php/standalone"; prettier.format(YOUR_CODE, { plugins: [phpPlugin], parser: "php" }); ``` ## Configuration Prettier for PHP supports the following options. We recommend that all users set the `phpVersion` option. | Name | Default | Description | | ------------------ | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `phpVersion` | `"5.4"` | Allows specifying the PHP version you're using. If you're using PHP 7.1 or later, setting this option will make use of modern language features in the printed output. If you're using PHP 5.3 or lower, you'll have to set this option or Prettier will generate incompatible code. | | `printWidth` | `80` | Same as in Prettier ([see prettier docs](https://prettier.io/docs/en/options.html#print-width)) | | `tabWidth` | `4` | Same as in Prettier ([see prettier docs](https://prettier.io/docs/en/options.html#tab-width)) | | `useTabs` | `false` | Same as in Prettier ([see prettier docs](https://prettier.io/docs/en/options.html#tabs)) | | `singleQuote` | `false` | If set to `"true"`, strings that use double quotes but do not rely on the features they add, will be reformatted. Example: `"foo" -> 'foo'`, `"foo $bar" -> "foo $bar"`. | | `trailingCommaPHP` | `true` | If set to `true`, trailing commas will be added wherever possible. <br> If set to `false`, no trailing commas are printed.