Difference between revisions of "fphttpclient"
Line 60: | Line 60: | ||
=== Upload a file using POST === | === Upload a file using POST === | ||
Use TFPHTTPClient.FileFormPost() | Use TFPHTTPClient.FileFormPost() | ||
− | ''' | + | <syntaxhighlight> |
+ | uses fphttpclient; | ||
+ | |||
+ | Var | ||
+ | Respo: TStringStream; | ||
+ | S : String; | ||
+ | |||
+ | begin | ||
+ | With TFPHttpClient.Create(Nil) do | ||
+ | try | ||
+ | Respo:=TStringStream.Create(''); | ||
+ | FileFormPost('http://example.com/upload.php','PostFilenameParam',edtSourceFile.Text,Respo); | ||
+ | S:=Respo.DataString; | ||
+ | Respo.Destroy; | ||
+ | finally | ||
+ | Free; | ||
+ | end; | ||
+ | end. | ||
+ | </syntaxhighlight> | ||
=== Get external IP address === | === Get external IP address === |
Revision as of 17:43, 20 October 2016
Overview
fphttpclient is supplied with FPC as part of the fcl-web package, and can be used by itself as well.
HTTPS (TLS/SSL)
Since April 2014, the trunk/development fphttpclient supports SSL/TLS connections using the OpenSSL library (will ship with version 2.8.0 and above). This requires the OpenSSL .so/.dll/.dylib library/libraries to be installed (e.g. present in your application or system directory on Windows).
- If you do not use client side certificates, just specifying the proper port (e.g. 443 for https) is enough to enable TLS/SSL as long as you have OpenSSL libraries installed (or e.g. in the application directory)
- If you want to use e.g. a client side certificate, do something like this:
uses ...ssockets, sslsockets..
// Callback for setting up SSL client certificate
procedure TSSLHelper.SSLClientCertSetup(Sender: TObject; const UseSSL: Boolean;
out AHandler: TSocketHandler);
begin
AHandler:=nil;
if UseSSL and (FClientCertificate<>'') then
begin
// Only set up client certificate if needed.
// If not, let normal fphttpclient flow create
// required socket handler
AHandler:=TSSLSocketHandler.Create;
// Example: use your own client certificate when communicating with the server:
(AHandler as TSSLSocketHandler).Certificate.FileName:=FClientCertificate;
end;
end;
//... and in your TFPHTTPClient creation:
myclient:=TFPHTTPClient.Create(nil);
if FClientCertificate<>'' then
myclient.OnGetSocketHandler:=@SSLClientCertSetup;
Examples
Examples are included in your FPC directory: packages/fcl-web/examples/
Apart from those, please see below:
Get body of a web page via HTTP protocol
uses fphttpclient;
Var
S : String;
begin
With TFPHttpClient.Create(Nil) do
try
S:=Get(ParamStr(1));
finally
Free;
end;
Writeln('Got : ',S);
end.
If you want to write even less lines of code, in FPC 2.7.1 you can use the class method:
s := TFPCustomHTTPClient.SimpleGet('http://a_site/a_page');
Upload a file using POST
Use TFPHTTPClient.FileFormPost()
uses fphttpclient;
Var
Respo: TStringStream;
S : String;
begin
With TFPHttpClient.Create(Nil) do
try
Respo:=TStringStream.Create('');
FileFormPost('http://example.com/upload.php','PostFilenameParam',edtSourceFile.Text,Respo);
S:=Respo.DataString;
Respo.Destroy;
finally
Free;
end;
end.
Get external IP address
If your computer is connected to the internet via a LAN (cabled or wireless), the IP address of your network card most probably is not your external IP address.
You can retrieve your external IP address from e.g. your router or an external site. The code below tries to get it from an external site (thanks to JoStudio on the forum for the inspiration: [1]):
{$mode objfpc}{$H+}
uses
Classes, SysUtils, fphttpclient, RegexPr;
function GetExternalIPAddress: string;
var
HTTPClient: TFPHTTPClient;
IPRegex: TRegExpr;
RawData: string;
begin
try
HTTPClient:=TFPHTTPClient.Create(nil);
IPRegex:=TRegExpr.Create;
try
//returns something like:
{
<html><head><title>Current IP Check</title></head><body>Current IP Address: 44.151.191.44</body></html>
}
RawData:=HTTPClient.Get('http://checkip.dyndns.org');
// adjust for expected output; we just capture the first IP address now:
IPRegex.Expression:=RegExprString('\b\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}\b');
//or
//\b(?:\d{1,3}\.){3}\d{1,3}\b
if IPRegex.Exec(RawData) then
begin
result:=IPRegex.Match[0];
end
else
begin
result:='Got invalid results getting external IP address. Details:'+LineEnding+
RawData;
end;
except
on E: Exception do
begin
result:='Error retrieving external IP address: '+E.Message;
end;
end;
finally
HTTPClient.Free;
IPRegex.Free;
end;
end;
begin
writeln('External IP address:');
writeln(GetExternalIPAddress);
end.