singleton method Net::IMAP.new

new(host, port = 143, usessl = false, certs = nil, verify = true) -> Net::IMAP[permalink][rdoc][edit]
new(host, options) -> Net::IMAP

新たな Net::IMAP オブジェクトを生成し、指定したホストの指定したポートに接続し、接続語の IMAP オブジェクトを返します。

usessl が真ならば、サーバに繋ぐのに SSL/TLS を用います。 SSL/TLS での接続には OpenSSL と openssl が使える必要があります。 certs は利用する証明書のファイル名もしくは証明書があるディレクトリ名を文字列で渡します。 certs に nil を渡すと、OpenSSL のデフォルトの証明書を使います。 verify は接続先を検証するかを真偽値で設定します。真が OpenSSL::SSL::VERIFY_PEER に、偽が OpenSSL::SSL::VERIFY_NONE に対応します。

パラメータは Hash で渡すこともできます。以下のキーを使うことができます。

  • :port ポート番号 省略時は SSL/TLS 使用時→993 不使用時→143 となります。
  • :ssl OpenSSL に渡すパラメータをハッシュで指定します。 省略時は SSL/TLS を使わず接続します。 これで渡せるパラメータは OpenSSL::SSL::SSLContext#set_params と同じです。

これの :ssl パラメータを使うことで、OpenSSL のパラメータを詳細に調整できます。

require 'net/imap'

imap = Net::IMAP.new('imap.example.com', :port => 993,
                     :ssl => { :verify_mode => OpenSSL::SSL::VERIFY_PEER,
                               :timeout => 600 } )
[PARAM] host:
接続するホスト名の文字列
[PARAM] port:
接続するポート番号
[PARAM] usessl:
真でSSL/TLSを使う
[PARAM] certs:
証明書のファイル名/ディレクトリ名の文字列
[PARAM] verify:
真で接続先を検証する
[PARAM] options:
各種接続パラメータのハッシュ