single_space_after_construct.rst 2.4 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970
  1. =====================================
  2. Rule ``single_space_after_construct``
  3. =====================================
  4. Ensures a single space after language constructs.
  5. Warning
  6. -------
  7. This rule is deprecated and will be removed on next major version
  8. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  9. You should use ``single_space_around_construct`` instead.
  10. Configuration
  11. -------------
  12. ``constructs``
  13. ~~~~~~~~~~~~~~
  14. List of constructs which must be followed by a single space.
  15. Allowed values: a subset of ``['abstract', 'as', 'attribute', 'break', 'case', 'catch', 'class', 'clone', 'comment', 'const', 'const_import', 'continue', 'do', 'echo', 'else', 'elseif', 'enum', 'extends', 'final', 'finally', 'for', 'foreach', 'function', 'function_import', 'global', 'goto', 'if', 'implements', 'include', 'include_once', 'instanceof', 'insteadof', 'interface', 'match', 'named_argument', 'namespace', 'new', 'open_tag_with_echo', 'php_doc', 'php_open', 'print', 'private', 'protected', 'public', 'readonly', 'require', 'require_once', 'return', 'static', 'switch', 'throw', 'trait', 'try', 'type_colon', 'use', 'use_lambda', 'use_trait', 'var', 'while', 'yield', 'yield_from']``
  16. Default value: ``['abstract', 'as', 'attribute', 'break', 'case', 'catch', 'class', 'clone', 'comment', 'const', 'const_import', 'continue', 'do', 'echo', 'else', 'elseif', 'enum', 'extends', 'final', 'finally', 'for', 'foreach', 'function', 'function_import', 'global', 'goto', 'if', 'implements', 'include', 'include_once', 'instanceof', 'insteadof', 'interface', 'match', 'named_argument', 'namespace', 'new', 'open_tag_with_echo', 'php_doc', 'php_open', 'print', 'private', 'protected', 'public', 'readonly', 'require', 'require_once', 'return', 'static', 'switch', 'throw', 'trait', 'try', 'use', 'use_lambda', 'use_trait', 'var', 'while', 'yield', 'yield_from']``
  17. Examples
  18. --------
  19. Example #1
  20. ~~~~~~~~~~
  21. *Default* configuration.
  22. .. code-block:: diff
  23. --- Original
  24. +++ New
  25. <?php
  26. -throw new \Exception();
  27. +throw new \Exception();
  28. Example #2
  29. ~~~~~~~~~~
  30. With configuration: ``['constructs' => ['echo']]``.
  31. .. code-block:: diff
  32. --- Original
  33. +++ New
  34. <?php
  35. -echo "Hello!";
  36. +echo "Hello!";
  37. Example #3
  38. ~~~~~~~~~~
  39. With configuration: ``['constructs' => ['yield_from']]``.
  40. .. code-block:: diff
  41. --- Original
  42. +++ New
  43. <?php
  44. -yield from baz();
  45. +yield from baz();