# CONFIG REWRITE **CONFIG REWRITE** [_CONFIG REWRITE_](#config-rewrite) 命令對啟動 Redis 服務器時所指定的 `redis.conf` 文件進行改寫： 因為 [_CONFIG SET_](config_set.html#config-set) 命令可以對服務器的當前配置進行修改， 而修改后的配置可能和 `redis.conf` 文件中所描述的配置不一樣， [_CONFIG REWRITE_](#config-rewrite) 的作用就是通過盡可能少的修改， 將服務器當前所使用的配置記錄到 `redis.conf` 文件中。 重寫會以非常保守的方式進行： * 原有 `redis.conf` 文件的整體結構和注釋會被盡可能地保留。 * 如果一個選項已經存在于原有 `redis.conf` 文件中 ， 那么對該選項的重寫會在選項原本所在的位置（行號）上進行。 * 如果一個選項不存在于原有 `redis.conf` 文件中， 并且該選項被設置為默認值， 那么重寫程序不會將這個選項添加到重寫后的 `redis.conf` 文件中。 * 如果一個選項不存在于原有 `redis.conf` 文件中， 并且該選項被設置為非默認值， 那么這個選項將被添加到重寫后的 `redis.conf` 文件的末尾。 * 未使用的行會被留白。 比如說， 如果你在原有 `redis.conf` 文件上設置了數個關于 `save` 選項的參數， 但現在你將這些 `save` 參數的一個或全部都關閉了， 那么這些不再使用的參數原本所在的行就會變成空白的。 即使啟動服務器時所指定的 `redis.conf` 文件已經不再存在， [_CONFIG REWRITE_](#config-rewrite) 命令也可以重新構建并生成出一個新的 `redis.conf` 文件。 另一方面， 如果啟動服務器時沒有載入 `redis.conf` 文件， 那么執行 [_CONFIG REWRITE_](#config-rewrite) 命令將引發一個錯誤。 ## 原子性重寫 對 `redis.conf` 文件的重寫是原子性的， 并且是一致的： 如果重寫出錯或重寫期間服務器崩潰， 那么重寫失敗， 原有 `redis.conf` 文件不會被修改。 如果重寫成功， 那么 `redis.conf` 文件為重寫后的新文件。 ## 可用版本 >= 2.8.0 ## 返回值 一個狀態值：如果配置重寫成功則返回 `OK` ，失敗則返回一個錯誤。 ## 測試 以下是執行 [_CONFIG REWRITE_](#config-rewrite) 前， 被載入到 Redis 服務器的 `redis.conf` 文件中關于 `appendonly` 選項的設置： ``` # ... 其他選項 appendonly no # ... 其他選項 ``` 在執行以下命令之后： ``` 127.0.0.1:6379> CONFIG GET appendonly # appendonly 處于關閉狀態 1) "appendonly" 2) "no" 127.0.0.1:6379> CONFIG SET appendonly yes # 打開 appendonly OK 127.0.0.1:6379> CONFIG GET appendonly 1) "appendonly" 2) "yes" 127.0.0.1:6379> CONFIG REWRITE # 將 appendonly 的修改寫入到 redis.conf 中 OK ``` 重寫后的 `redis.conf` 文件中的 `appendonly` 選項將被改寫： ``` # ... 其他選項 appendonly yes # ... 其他選項 ```