https://github.com/randomsymbols/fsubmit

PHP library to submit HTML forms.
https://github.com/randomsymbols/fsubmit

curl html-forms

Last synced: 2 months ago
JSON representation

PHP library to submit HTML forms.

• Host: GitHub
• URL: https://github.com/randomsymbols/fsubmit
• Owner: randomsymbols
• License: lgpl-3.0
• Created: 2020-05-23T20:39:39.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2022-06-29T11:48:07.000Z (over 2 years ago)
• Last Synced: 2024-09-18T02:22:50.725Z (4 months ago)
• Topics: curl, html-forms
• Language: PHP
• Homepage: https://github.com/randomsymbols/fsubmit
• Size: 39.1 KB
• Stars: 2
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# fsubmit

Have you ever tried to submit an HTML form with cUrl?

You have to clearly state all the fields you submit and what values they have. 

In real life, we most often only want to fill in one or two fields without even thinking about what other fields are.

If you hardcode the other fields' values into your cUrl request, what if the form changes over time?

You code will be broken. 

To keep you code adoptable to the changes of the form, you will have to download the form as is first, 

parse its fields and values, change/add values to the right fields and submit it with cUrl. 

It causes a lot of questions if you do not know how HTML forms work. 

For example, if there is a select tag with several options, 

which one will be submitted as the value for the field if none is selected? What if the option tag has no value attribute?

An Internet browser does the job for us when we submit a form. 

We do not have to bother about hidden fields or any other fields at all. The library provides the same functionality for PHP.

## Requirements

PHP 7.4 and later.

## Composer

You can install the library via [Composer](http://getcomposer.org/). Run the following command:

```bash

composer require randomsymbols/fsubmit

```

To use the library, use composer's [autoload](https://getcomposer.org/doc/01-basic-usage.md#autoloading):

```php

require_once('vendor/autoload.php');

```

## Dependencies

The library requires the following extensions in order to work properly:

-   [`curl`](https://secure.php.net/manual/en/book.curl.php)

-   [`openssl`](https://www.php.net/manual/en/openssl.installation.php)

-   [`PHP Simple HTML DOM Parser`](https://github.com/voku/simple_html_dom)

If you use Composer, these dependencies should be handled automatically. If you install manually, make sure these extensions are available.

## Getting Started

```php

use Fsubmit\Form;

$form = Form::fromUrl('https://www.google.com');

$form->setParams(['q' => 'John 3:16']);

$answer = $form->submit();

echo $answer['content'];

```