---
title: "ngx_mruby v2.7.8"
language: "ja"
documentation_version: "3.x"
channel: "development"
release_context: null
source_revision: "2072a900b0d0eae8e61fafb06e4c0129bc43c245"
working_tree_clean: true
source_path: "docs/releases/v2.7.8.ja.md"
source_sha256: "e43ca0d818b6c886bae8905671705fbac692617e4a84fd1b98413b5856f6bf4e"
source_at_revision: true
source_url: "https://github.com/matsumotory/ngx_mruby/blob/2072a900b0d0eae8e61fafb06e4c0129bc43c245/docs/releases/v2.7.8.ja.md"
html_url: "https://ngx.mruby.org/ja/releases/v2.7.8/"
markdown_url: "https://ngx.mruby.org/markdown/ja/releases/v2.7.8.md"
last_updated: "2026-11-15"
---

# ngx_mruby v2.7.8

## 更新前に確認する挙動の変更

### `Nginx.redirect`はIntegerでないステータスコードに、`add_listener`はStringでない`:address`に`TypeError`を出します(#813)

アドバイザリ(URLへの`Nginx.redirect`のステータスコードについて)：[GHSA-8j8w-mcp5-xp3h](https://github.com/matsumotory/ngx_mruby/security/advisories/GHSA-8j8w-mcp5-xp3h)

- 変更前：`Nginx.redirect`は、URLへのリダイレクトのステータスコードである第2引数を、型を確かめずにIntegerとして読んでいました。StringかFloatを渡すと、応答には`Location`ヘッダが付き、ステータスラインにはステータスコードではない数が入り、理由のフレーズはありませんでした。`nil`を渡すと、クライアントには応答が返らず、接続が閉じられました。`Nginx::Server#add_listener`と`Nginx::Stream.add_listener`は、Hashの`:address`を、型を確かめずにStringとして読んでいました。`:address`が無いか、`nil`か、IntegerのようにStringでない値だと、nginxは設定を読み込む途中でセグメンテーション違反で終わりました。`nginx -t`でも同じでした。
- 変更後：URLへのリダイレクトで、ステータスコードがIntegerでないと、`Nginx.redirect`は`TypeError`を出します。メッセージは、値のクラスを入れた`String cannot be converted to Integer`か、`nil cannot be converted to Integer`です。スクリプトのほかの例外と同じに、この例外でもハンドラは終わります。スクリプトは`rescue`でこの例外を捕まえられます。捕まえなければ、ngx_mrubyは例外をログに書き、リクエストは500になります。リダイレクトはせず、`Location`ヘッダも付けません。内部リダイレクトにはステータスコードが無く、これまでどおり第2引数を使いません。`add_listener`は`TypeError`を出します。メッセージは、値のクラスを入れた`Integer cannot be converted to String`か、`:address`が無いか`nil`のときの`nil cannot be converted to String`です。この例外は`mruby_server_context_handler_code`か`mruby_stream_server_context_code`のコードに届き、nginxは設定の読み込みを止めます。`nginx -t`は失敗し、`mrb_run failed`の後に例外を表示します。
- 変更の理由：
  - 不具合：これらのメソッドは、引数を型を確かめずに読んでいました。そのため、ほかの型の値を渡すと、有効なステータスの無い応答になるか、応答が返らないか、nginxのプロセスが終わりました。URLへのリダイレクトでは、Stringのようなヒープに置かれたステータスコードを渡すと、ワーカープロセスのヒープのアドレスがステータスラインに入り、ASLRが弱まりました。詳細は、上にリンクしたアドバイザリが示します。この項目の`add_listener`の確認は、同じ見直しによる運用者向けの堅牢化で、クライアントからは到達しません。Requestのセッター、`Nginx::Async::HTTP.sub_request`、`Nginx::Headers_in/out#[]=`は、2.7.7で同じ確認をするようになりました。`Nginx.redirect`は、2.7.6から第1引数を確かめています(#775)。
  - 前の挙動を残せなかった理由：Integerでない値にはステータスコードが無く、Stringでない値にはアドレスが無いので、そのように読んだ結果は決まりません。変換して受け付けると、これらのメソッドがこれまで受け付けていなかった型を受け付けることになります。2.x系では、そのような変更はしません。
  - ドキュメントが示していた挙動：2.7.7の[Nginx.redirect](https://github.com/matsumotory/ngx_mruby/blob/v2.7.7/docs/class_and_method/README.md#nginxredirecturl_or_internal_location-http_statusnginxhttp_moved_temporarily)は、第2引数を`http_status`と呼び、既定の値にIntegerの定数を示していました。ほかの値については、何も書いていませんでした。[Nginx::Server#add_listener](https://github.com/matsumotory/ngx_mruby/blob/v2.7.7/docs/class_and_method/README.md#nginxserveradd_listenerhash)と[Nginx::Stream.add_listener](https://github.com/matsumotory/ngx_mruby/blob/v2.7.7/docs/class_and_method/README.md#nginxstreamadd_listener)は、どの例でもStringの`:address`を示していました。ほかの値については、何も書いていませんでした。
- 影響の範囲：Integerでない第2引数を渡す、URLへの`Nginx.redirect`の呼び出しと、Hashに`:address`が無いか、Stringでない`:address`を渡す、`Nginx::Server#add_listener`と`Nginx::Stream.add_listener`の呼び出しです。内部リダイレクト、Integerのステータスコード、Stringの`:address`は、前と同じに動きます。
- 必要な対応：`Nginx.redirect`には、`Nginx::HTTP_MOVED_PERMANENTLY`のようなIntegerのステータスコードを渡すか、302にするなら省いてください。`add_listener`の`:address`は、`port.to_s`のようにStringで渡してください。ほかの値を渡すコードは、2.7.7でも動いていませんでした。

### `Nginx.redirect`は3つ目の引数に`ArgumentError`を出します(#813)

- 変更前：`Nginx.redirect`は、URLか内部のlocationと、省略できるステータスコードを取ります。しかし、引数を3つ渡してもエラーになりませんでした。このメソッドがmrubyに渡す引数の形式は3つの引数を許し、受け取る変数は2つしか渡していませんでした。形式と変数の数が合っておらず、引数を3つ渡したときの結果は定まっていませんでした。引数を4つ以上渡すと、今と同じく`ArgumentError`が出ていました。
- 変更後：引数を3つ渡すと、`Nginx.redirect`は何もする前に`ArgumentError`を出します。メッセージは`wrong number of arguments (given 3, expected 1..2)`です。URLでも内部のlocationでも同じです。スクリプトのほかの例外と同じに、この例外でもハンドラは終わります。スクリプトは`rescue`でこの例外を捕まえられます。捕まえなければ、ngx_mrubyは例外をログに書き、リクエストは500になります。リダイレクトはしません。
- 変更の理由：
  - 不具合：`ngx_mrb_redirect`の引数の形式は3つの引数を挙げていて、受け取る変数は2つしか渡していませんでした(#813)。
  - 前の挙動を残せなかった理由：引数を3つ渡したときの結果は定まっていなかったので、残すことはできませんでした。このメソッドには、意味を与えられる3つ目の引数がありません。また、メソッドが取るより多い引数を渡されたとき、mrubyは`ArgumentError`を出します。
  - ドキュメントが示していた挙動：2.7.7の[Nginx.redirect](https://github.com/matsumotory/ngx_mruby/blob/v2.7.7/docs/class_and_method/README.md#nginxredirecturl_or_internal_location-http_statusnginxhttp_moved_temporarily)の見出しは、2つの引数を挙げていました。3つ目の引数については、何も書いていませんでした。
- 影響の範囲：引数を3つ渡す`Nginx.redirect`の呼び出しです。
- 必要な対応：`Nginx.redirect`には、引数を1つか2つ渡してください。URLか内部のlocationと、URLで302以外にするならステータスコードです。

## 新機能

ありません。

## 不具合の修正

- URLへの`Nginx.redirect`はステータスコードがIntegerであることを、`Nginx::Server#add_listener`と`Nginx::Stream.add_listener`は`:address`がStringであることを確かめるようになりました。ほかの型の値には`TypeError`を出します。これまでは、ほかの型のステータスコードでは有効なステータスの無い応答になるか応答が返らず、ほかの型の`:address`か`:address`が無いと、設定を読み込む途中でnginxが終わりました(#813)。
- `Nginx.redirect`は引数を1つか2つ取り、3つ目の引数には`ArgumentError`を出します。これまでは、引数の形式と受け取る変数の数が合っておらず、引数を3つ渡したときの結果は定まっていませんでした(#813)。

## ビルドとテストの変更

- 新しいテストのケースとして、`test/t/cases/argument_types.rb`と、ポート18200の`test/conf/conf.d/96-argument-types.conf`のサーバーを加えました(#813)。

## アップグレード

- ディレクティブの追加、名前の変更、削除はありません。2.7.7と同じ方法でこのリリースのモジュールをビルドし、バイナリか動的モジュールを置き換えてください。

アップグレードの前に、次の点を確かめてください。各行は、項目の「必要な対応」です。

- URLへの`Nginx.redirect`にIntegerでないステータスコードを渡す呼び出しと、Stringの`:address`を渡さない`add_listener`の呼び出し：Integerのステータスコードを渡すか、302にするなら省いてください。`:address`はStringで渡してください。
- 引数を3つ渡す`Nginx.redirect`の呼び出し：1つか2つにしてください。
