Title: WP_CLI::read_value()
Published: June 12, 2025
Last modified: July 21, 2026

---

# WP_CLI::read_value()

## In this article

 * [Usage](https://make.wordpress.org/cli/handbook/references/internal-api/wp-cli-read-value/?output_format=md#usage)
 * [Related](https://make.wordpress.org/cli/handbook/references/internal-api/wp-cli-read-value/?output_format=md#related)

Read a value, from various formats.

---

## 󠀁[Usage](https://make.wordpress.org/cli/handbook/references/internal-api/wp-cli-read-value/?output_format=md#usage)󠁿

    ```
    WP_CLI::read_value( $raw_value, $assoc_args = [] )
    ```

 **$raw_value** (string) 
 **$assoc_args** (array)

_Internal APIAPI An API or Application Programming Interface is a software intermediary
that allows programs to interact with each other and share data in limited, clearly
defined ways. documentation is generated from the WP-CLIWP-CLI WP-CLI is the Command
Line Interface for WordPress, used to do administrative and development tasks in
a programmatic way. The project page is [http://wp-cli.org/](http://wp-cli.org/)
[https://make.wordpress.org/cli/](https://make.wordpress.org/cli/) codebase on every
release. To suggest improvements, please submit a pull request._

---

## 󠀁[Related](https://make.wordpress.org/cli/handbook/references/internal-api/wp-cli-read-value/?output_format=md#related)󠁿

 * **[WP_CLI\Utils\launch_editor_for_input()](https://make.wordpress.org/cli/handbook/internal-api/wp-cli-utils-launch-editor-for-input/)**–
   Launch system’s $EDITOR for the user to edit some text.
 * **[WP_CLI\Utils\get_flag_value()](https://make.wordpress.org/cli/handbook/internal-api/wp-cli-utils-get-flag-value/)**–
   Return the flag value or, if it’s not set, the $default value.
 * **[WP_CLI\Utils\report_batch_operation_results()](https://make.wordpress.org/cli/handbook/internal-api/wp-cli-utils-report-batch-operation-results/)**–
   Report the results of the same operation against multiple resources.
 * **[WP_CLI\Utils\parse_str_to_argv()](https://make.wordpress.org/cli/handbook/internal-api/wp-cli-utils-parse-str-to-argv/)**–
   Parse a string of command line arguments into an $argv-esqe variable.
 * **[WP_CLI::confirm()](https://make.wordpress.org/cli/handbook/internal-api/wp-cli-confirm/)**–
   Ask for confirmation before running a destructive operation.
 * **[WP_CLI::has_config()](https://make.wordpress.org/cli/handbook/internal-api/wp-cli-has-config/)**–
   Confirm that a global configuration parameter does exist.
 * **[WP_CLI::get_config()](https://make.wordpress.org/cli/handbook/internal-api/wp-cli-get-config/)**–
   Get values of global configuration parameters.

First published

June 12, 2025

Last updated

July 21, 2026

Edit article

[ Improve it on GitHub: [article_title] ](https://github.com/wp-cli/handbook/edit/main/internal-api/wp-cli-read-value.md)

Changelog

[ See list of changes: [article_title] ](https://github.com/wp-cli/handbook/commits/main/internal-api/wp-cli-read-value.md)

[  Previous: WP_CLI::log()](https://make.wordpress.org/cli/handbook/references/internal-api/wp-cli-log/)

[  Next: WP_CLI::runcommand()](https://make.wordpress.org/cli/handbook/references/internal-api/wp-cli-runcommand/)