Skip to content

Latest commit

 

History

History
379 lines (257 loc) · 10.2 KB

File metadata and controls

379 lines (257 loc) · 10.2 KB

NAME

HTTP::Cookies - ��壔����㏍�弱俉��

SYNOPSIS

use HTTP::Cookies;
$cookie_jar = HTTP::Cookies->new(
  file => "$ENV{'HOME'}/lwp_cookies.dat',
  autosave => 1,
);

use LWP;
my $browser = LWP::UserAgent->new;
$browser->cookie_jar($cookie_jar);

�����������壔��腥冴�勐俉������筝���������壔����㏍�弱俉�����勐�翫�����:

use LWP;
my $browser = LWP::UserAgent->new;
$browser->cookie_jar( {} );

DESCRIPTION

�����勉�壔�í�鴻�壔�������壔����㏍�弱俉������-- ��������壔��筝������������� LWP::UserAgent ��ŝ����吾�с�壔�������ャ�c�⓾����������⓾�� HTTP ��壔����㏍�若�勉����若�帥����若�� -- ���茵◐憗�������ŝ����吾�с�壔����勉�������勉����勉�с�����

��壔����㏍�� (Cookie) ��壔����泣�若����弱�眼�勖・膓�����・膓���勉�壔�í�ゃ�≪�潟����眼�������宴����主�������� ��������冴�����������筝≧�鴻����堺�ャ��筝���㋜����ʋ����純�с����� ��壔����㏍�若�˨�ゃ����⓾�勉�������ŝ�������宴� <URL:http://curl.haxx.se/rfc/cookie_spec.html> �� <URL:http://www.cookiecentral.com/> ������荀т����������� �����勉�≪�吾�ャ�若�˨� RFC 2965 ��ц��菴違�������⓾�������違�����綵√����勉�壔����㏍�若��絎�茖������障����� ��壔����㏍�若�勌����ゃ�勐����違�壠晃��������怨����с����������勉����喝����������障�����

HTTP::Cookies ��壔�í�鴻�勉�ゃ�潟�鴻�帥�潟�鴻�� Set-Cookie2: �� Set-Cookie: �����������勰����障�������主�������������������с����������勖����宴�� HTTP::Request ��ŝ����吾�с�壔����� Cookie ����������������������������������� 篏帥�������������堺�ャ�障����� HTTP::Cookies ��ŝ����吾�с�壔����勛�倶����壔����<�ゃ�˨����主����с����������<�ゃ�˨����� ���緇������������������с����障�����

METHODS

篁ヤ����勉�<�純�����������箴���������障��:

��潟�潟�鴻����í�壔�帥�壔�������激�ュ就綣���勉����í�<�若�帥����������障����� 篁ヤ����勉����í�<�若�帥�����茹c�������障��:

file:            ��壔����㏍�若����������冴��������篆�絖���������������<�ゃ�˨�勐�����
autosave:        ��ŝ����吾�с�壔����勉����鴻����í�壔�激�с�喝�☎��筝㏍�˩��絖������� (bool) 
ignore_discard:  綮�罍���������������̬��羆������������壔����㏍�若�с����c�⓾��篆�絖������� (bool) 
hide_cookie2:    ��ŝ�壔����鴻����� Cookie2 ������������菴遵�������ŝ��

絨���ヤ札筝���勉����í�<�若�帥����ャ����障�� (��障��絎�茖���������⓾����障�����):

max_cookies               300
max_cookies_per_domain    20
max_cookie_size           4096

no_cookies   list of domain names that we never return cookies to

add_cookie_header() ��<�純�������奝�ï����� Cookie:-��������� ���綣���違������� 筝������������� HTTP::Request ��ŝ����吾�с�壔����̬┃絎������障����� �����勉�<�純����������若�違����������˨��$request ��奝�ï����� url 絮���с�� ��������ŝ�������違�ŝ����障��������

extract_cookies() ��<�純�������� Set-Cookie: ��� Set-Cookie2: ���綣���違������� 羝<�������� HTTP::Response �������「�����障����� 荀���ゃ����c�������������勉����������壔����鴻�⓾��$cookie_jar ��勛�倶�������贋�違������������� 篏帥�������障�����

set_cookie() ��<�純�������� $cookie_jar ��勛�倶�������贋�違����障����� $key, $val, $domain, $port, $path 綣���違�壩��絖������с����� $path_spec, $secure, $discard 綣���違�壔����若����ゃ�с����� $maxage ��壔����勉�壔����㏍�若����������⓾�����腱���違��腓冴����障����� ��ゃ�� <=0 ��壔����勉�壔����㏍�若�������ゃ����障����� %rest ��� "Comment" ��� "CommentURL" ��勉�������ŭ����勖�������ɱ����с��絎�臂í����障�����

�����勉�<�純�������� $cookie_jar ��勛�倶����������<�ゃ�˨�˩��絖������障����� �����勛�倶����� load() ��<�純��������篏帥�c�☗�������冴�������������堺�ャ�障����� �����������<�ゃ�����������絎���������ŝ�������違����潟�潟�鴻����í�壔�帥�ф��絎���������� ���������篏睡�������障����� 絮���� ignore_discared ���荐㊤�������������違��綮�罍������������������違�勉�ゃ����� ��壔����㏍�若��篆�絖������障�����

��������í�˨����� "Set-Cookie3" ��勤����勌研��潟��篆�絖������障����� "Set-Cookie3" ��� LWP 絨������勉����í�若����������с�����篁���勉����í�⓾�吟����勌�������с� �����������障�������� HTTP::Cookies::Netscape ��泣����壔�í�鴻�� Netscape ���篋������с�勉����� �����í�若����������т��絖���������������˩戎��������障�����

�����勉�<�純�������壔����<�ゃ�˨�������壔����㏍�若��茯㏍�帥����帥��$cookie_jar ��̬申��������障����� �����<�ゃ�˨�� save() ��<�純�������˨�������吾�������������í�若����������с�ŝ�������違�ŝ����障��������

�����勉�<�純�������� $cookie_jar ���腥冴�����������緇���˩��絖������������<�ゃ�˨����� $cookie_jar �����ŝ�㏍�若�������障�����

綣���亥�<����с����勉�<�純����������若�喝�冴����� $cookie_jar ���篏����腥冴�˨����障����� ������筝���ゃ�勐����違��������筝���������������違�������勉����<�ゃ�潟�����絮���������壔����㏍�若�������� �����ゃ�������障����� 綣���違��篋���や�����������������������絎���������������<�ゃ�潟�˨����������勉����鴻�����絮������� ��壔����㏍�若�������������ゃ�������障����� 筝���ゃ�勐����違��筝�������������������絎������������㏍�若�������鴻�������⓾����<�ゃ�潟������� ��壔����㏍�若�������ゃ�������障�����

�����⓾�勌����������壔����㏍�若����贋�������障����� 絎劫����勌賢��������������号����������c�若�˨�������ŝ��������discard �����í�違������� ��壔����㏍�若���「�����障����� RFC 2965 ��˨�������違����⓾�若�吟�若����若�吾�с�潟�������激�c����������⓾�潟������������� ��若�喝�冴�������障�����

綣���違�壔�壔����㏍�若�� $cookie_jar �����主����������������潟����若�喝�冴�������� ��泣����˨�若����潟�с����� ��泣����˨�若����潟�壚札筝���勐����違�у�若�喝�冴�������障��:

0  �����若�吾�с�� (version)
1  ��㏍�� (key) 
2  ��� (val) 
3  ������ (path) 
4  �����<�ゃ�� (domain) 
5  �����若�� (port) 
6  �����号��絎� (path_spec) 
7  ��祉�㏍�ャ�ŝ����� (secure) 
8  腟�篋� (expires) 
9  綮�罍� (discard) 
 10  ��������激�� (hash) 

as_string() ��<�純�������� "\n" ��у�阪����������� "Set-Cookie3" ���������茵���勌研��潟� 茵���������� $cookie_jar ��勛�倶�����菴������障����� $skip_discard ��� TRUE ��с�������違��Discard 絮���с�������c����壔����㏍�若�勉�������勤���� 菴������障��������

SEE ALSO

HTTP::Cookies::Netscape, HTTP::Cookies::Microsoft

COPYRIGHT

Copyright 1997-2002 Gisle Aas

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.