gilangwinduasmara / laravel-odoo
A Laravel package to easily integrate with Odoo via XML-RPC.
Requires
- php: ^8.2
- darkaonline/ripcord: ^0.1.7
This package is auto-updated.
Last update: 2025-09-05 02:48:37 UTC
README
Laravel 11 and higher
Laravel 8 and higher
Odoo 8.0 and higher
Php 8.2 and higher
🔧 Setup
This package depends on the PHP xmlrpc
extension, which is not available by default in PHP 8.3. You need to install it manually to ensure the package works correctly.
🪟 Windows
-
Download the prebuilt DLL from the official PHP archives: 👉 xmlrpc-1.0.0RC3 for Windows
-
Add the
.dll
to your PHPext
directory. -
Enable it by adding this line to your
php.ini
:extension=php_xmlrpc.dll
-
Restart your web server or PHP process.
🐧 Ubuntu (PHP 8.3)
📦 Standard installation
sudo apt-get update sudo apt-get install -y libexpat1 sudo pecl install channel://pecl.php.net/xmlrpc-1.0.0RC3 echo "extension=xmlrpc.so" | sudo tee /etc/php/8.3/mods-available/xmlrpc.ini sudo phpenmod xmlrpc sudo systemctl restart apache2 # or php-fpm, depending on your setup php -m | grep xmlrpc # confirm the extension is loaded
🛠 Manual Compilation (if undefined symbol: XML_ParserCreate
error appears)
If you see this error when running your app:
symbol lookup error: /usr/lib/php/20230831/xmlrpc.so: undefined symbol: XML_ParserCreate
Follow these steps to build the extension manually:
1. Download and extract the source:
pecl download xmlrpc-1.0.0RC3
tar -xf xmlrpc-1.0.0RC3.tgz
cd xmlrpc-1.0.0RC3
2. Prepare and compile:
phpize ./configure --with-expat make sudo make install
3. Enable and restart PHP:
echo "extension=xmlrpc.so" | sudo tee /etc/php/8.3/mods-available/xmlrpc.ini sudo phpenmod xmlrpc sudo systemctl restart apache2 # or php-fpm
4. Confirm it's working:
php -m | grep xmlrpc ldd /usr/lib/php/20230831/xmlrpc.so | grep expat
🧯 If you get a libxml/parser.h
error during compilation
fatal error: libxml/parser.h: No such file or directory
Install the required development headers:
sudo apt-get update sudo apt-get install -y libxml2-dev
If the issue persists, run:
cd /usr/include/libxml2
sudo cp -R libxml/ ../
Installation
This package is installed via Composer. To install, run the following command.
composer require gilangwinduasmara/laravel-odoo
Publish the package's configuration file to the application's own config directory
php artisan vendor:publish --provider="GilangWinduAsmara\LaravelOdoo\Providers\OdooServiceProvider" --tag="config"
This package supports autodiscover.
If you don't use autodiscover for reasons, you can add the provider as described below.
Register Laravel Odoo Api service by adding it to the providers array.
'providers' => array( ... GilangWinduAsmara\LaravelOdoo\Providers\OdooServiceProvider::class )
You can also add the Alias facade.
'aliases' => array( ... 'Odoo' => GilangWinduAsmara\LaravelOdoo\Facades\Odoo::class, )
Configuration
After publishing the package config file, the base configuration for laravel-odoo-api package is located in config/laravel-odoo-api.php
Also, you can dynamically update those values calling the available setter methods:
host($url)
, username($username)
, password($password)
, database($name)
, apiSuffix($name)
Usage samples
Instance the main Odoo class:
$odoo = new \GilangWinduAsmara\LaravelOdoo\Odoo();
You can get the Odoo API version just calling the version method:
$version = $odoo->version();
This methods doesn't require to be connected/Logged into the ERP.
Connect and log into the ERP:
$odoo = $odoo->connect();
All needed configuration data is taken from laravel-odoo-api.php
config file. But you always may pass new values on the fly if required.
$this->odoo = $this->odoo ->username('my-user-name') ->password('my-password') ->database('my-db') ->host('https://my-host.com') ->connect();
// Note:
host
should contain 'http://' or 'https://'
After login, you can check the user identifier like follows:
$userId = $this->odoo->getUid();
You always can check the permission on a specific model:
$can = $odoo->can('read', 'res.partner');
Permissions which can be checked: 'read','write','create','unlink'
Method `search provides a collection of ids based on your conditions:
$ids = $odoo ->model('res.partner') ->where('customer', '=', true) ->search();
You can limit the amount of data using limit
method and use as many as condition you need:
$ids = $odoo ->model('res.partner') ->where('is_company', true) ->where('customer', '=', true) ->limit(3) ->search();
If need to get a list of models, use the get
method:
$models = $odoo ->model('res.partner') ->where('customer', true) ->limit(3) ->get();
Instead of retrieving all properties of the models, you can reduce it by adding fields
method before the method get
$models = $odoo ->model('res.partner') ->where('customer', true) ->limit(3) ->fields(['name']) ->get();
If not sure about what fields a model has, you can retrieve the model structure data by calling fieldsOf
method:
$structure = $odoo ->model('res.partner') ->listModelFields();
Till now we have only retrieved data from Odoo but you can also Create and Delete records.
In order to create a new record just call create
method as follows:
$id = $odoo ->model('res.partner') ->create(['name' => 'Bobby Brown']);
The method returns the id of the new record.
For Deleting records we have the delete
method:
$result = $odoo ->model('res.partner') ->where('name', '=', 'Bobby Brown') ->delete();
Notice that before calling
delete
method you have to usewhere
.
You can also remove records by ids like follows:
$result = $odoo ->model('res.partner') ->deleteById($ids);
Update any record of your Odoo:
$updateSuccessfull = $odoo ->model('res.partner') ->where('name', '=', 'Bobby Brown') ->update(['name' => 'Dagobert Duck','email' => 'daduck@odoo.com']);
Notice that all delete
and update
methods always returns true
except if there was an error.
Custom api Calls are also supported
$ids = $odoo ->model('res.partner') ->setMethod('search') ->setArguments([[ ['is_company', '=', true] ]]) ->setOption('limit', 3) ->addResponseClass(Odoo\Response\ListResponse::class) ->get();