**The minimum PHP version required to run Arcanist is now PHP 5.5**, which was released seven years ago in 2013. Requiring this version of PHP allows Arcanist to use a few new language features, including: traits; `yield`; and `finally`. See T11968 for some details.
**libphutil is no longer required.** All the code in "libphutil/" which Arcanist requires has been merged into "arcanist/". "libphutil/" is now an empty repository with a README file. See T13395 for discussion.
These flags to `arc` workflows have been removed:
| **arc diff** | `--plan-changes` | {icon times color=red} Removed, see T13010. Try `--draft`.
|---|
| | `--preview` | {icon times color=red} Removed, see T13010. Try `--draft`.
| | `--no-diff` | {icon times color=red} Removed, see T13010. Legacy flag.
| | `--cache` | {icon times color=red} Removed, see T13010. Legacy flag.
| **arc lint** | `--only-changed` | {icon times color=red} Removed. Try "warning" severity.
|---|
| | `--only-new` | {icon times color=red} Removed. Almost never worked correctly.
| | `--cache` | {icon times color=red} Removed. Legacy flag.
---
These minor behaviors have also changed:
**Configuration**
- The `arc.lint.cache` configuration setting has been removed.
**CLI/Scripting Behaviors**
- `arc` no longer exits with error code 77 to indicate invalid flags.
- Configuration flags must now be specified before workflows. For example, `arc --config x=y diff` is valid, but `arc diff --config x=y` is not valid.
- When stdout is not a TTY (usually, this means you're running `arc` in a script/non-interactive environment), command line flags must now be explicitly terminated with `--` (the "end of flags" argument), even if there are no flags, or no arguments, or the command you are executing can not take flags or arguments or is otherwise completely unambiguous. This makes it more difficult to write unsafe code. See T12961 for rationale.
Here's how to terminate flags with `--` for various argument lists:
| Unsafe Command | Properly Terminated Command |
|---|---|
| `arc diff` | `arc diff --` |
| `arc browse file.txt` | `arc browse -- file.txt` |
| `arc diff --draft` | `arc diff --draft --` |
| `arc lint --output xml example.js` | `arc lint --output xml -- example.js` |
**Workflow: Liberate**
- `arc liberate` now liberates all libraries under the current working directory if given no arguments.
- The flags `--library-name`, `--force-update`, `--remap`, and `--verify` no longer exist.
- The flag `--upgrade` no longer exists. v1 libraries can no longer be upgraded to v2. If you have a library which is 5+ years old, remove all the `__init__.php` files and then just do a clean liberate on it.
- The flag `--all` has been renamed to `--clean` (like `make clean`), for consistency with other commands and to disambiguate the new default behavior of rebuilding all libraries in subdirectories.