Difference between revisions of "fphttpclient"

From Free Pascal wiki
Jump to navigationJump to search
Line 60: Line 60:
 
=== Upload a file using POST ===
 
=== Upload a file using POST ===
 
Use TFPHTTPClient.FileFormPost()
 
Use TFPHTTPClient.FileFormPost()
'''to do: add exact example code'''
+
<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.

Translate text using Google Translate

See Using Google Translate