Joomla Framework

<section data-background="images/25-joomla-framework/framework.jpg" data-state="frontpage">
<div class="atitle2" style="padding:10px;background-color: rgba(0, 0, 0, 0.4);">What is<br>
    <div class="atitle" style="background-color: rgba(0, 0, 0, 0.7);font-size:200% !important"><span class="db8orange">Joomla Framework</span></div>
        <div class="atitle2" style="padding:10px;">and how to use it...</div>
        <br><br><br><br>
        <span class="apage1">by Peter Martin / <a href="https://db8.nl" target="_blank">db8.nl</a></span>
        <br>
        <span class="apage1">slides: <a href="https://petermartin.nl" target="_blank">
https://petermartin.nl</a></span>
        <style>.atitle{text-shadow: 2px 2px 2px #000;}
        .atitle2{text-shadow: 2px 2px 2px #000;}
        </style>
        <div style="margin: 0 auto;">
        <a href="https://db8.nl" title="Joomla Specialist db8 Nijmegen" target="_blank">
            <img height="50" style="border:0;background:transparent;margin-right:20px;
            box-shadow: 0 0 0 rgba(0, 0, 0, 0.15);" src="images/db8-logo.svg" alt="db8">
        </a>
    </div>
</div>

---

<div class="title" style="font-size: 60%;"><span class="db8orange">Joomla Framework</span><br>
    <ul style="font-size: 70%">
        <li>What is Joomla Framework</li>
        <li>Libraries</li>
        <li>Using libraries inside Joomla</li>
        <li>Using libraries outside Joomla</li>
    </ul>
</div>

---

<div class="title">What is <span class="db8orange">Joomla Framework</span><br>
</div>

----

### Why this talk?

<ul>
<li>Most people think <span class="db8orange">Joomla = CMS</span> only</li>
<li class="fragment">Under the hood:<br><span class="db8orange">framework of modular PHP packages</span></li>
<li class="fragment">Used <span class="db8orange">inside</span> Joomla</li>
<li class="fragment">Usable <span class="db8orange">outside</span> Joomla<br>(CLI tools, microservices, standalone apps)</li>
</ul>

----

### What is the Joomla Framework?

<ul>
<li>A set of <span class="db8orange">decoupled PHP packages</span></li>
<li class="fragment">Each package <span class="db8orange">does one job well</span></li>
<li class="fragment">Installable via <span class="db8orange">Composer</span> (from <span class="db8orange">Packagist</span>)</li>
<li class="fragment">Usable <span class="db8orange">without</span> the Joomla CMS</li>
</ul>

----

### Examples of packages

<ul>
<li class="fragment"><span class="db8orange">Database</span> connection/queries</li>
<li class="fragment"><span class="db8orange">HTTP</span> client / request & response</li>
<li class="fragment"><span class="db8orange">Filesystem</span> abstractions</li>
<li class="fragment"><span class="db8orange">Event</span> system</li>
<li class="fragment"><span class="db8orange">Registry</span> (config management)</li>
</ul>

<small class="fragment">See: <a href="https://framework.joomla.org/" target="_blank">framework.joomla.org</a> 
and <a href="https://packagist.org/?query=joomla" target="_blank">Packagist</a> for the full list.</small>

---

<div class="title"><span class="db8orange">Libraries</span><br>
<span style="font-size:50%;">Reusing PHP code....</span>
</div>

----

### PHP Libraries

<ul>
<li><span class="db8orange">Save time</span> - don’t reinvent the wheel</li>
<li><span class="db8orange">Quality & security</span> - tested by the community</li>
<li><span class="db8orange">Consistency</span> - follow standards (PSR, coding style)</li>
<li><span class="db8orange">Maintainability</span> - easier upgrades and bug fixes)</li>
<li><span class="db8orange">Ecosystem</span> - uncountable open-source solutions</li>
</ul>

----

### <span class="db8orange">Confession</span> (don't tell anyone!)

<ul>
<li class="fragment">I used a <span class="db8orange">PDF library</span> to generate PDFs</li>
<li class="fragment">downloaded from <a href="https://phpclasses.org/" target="_blank">phpclasses.org</a></li>
</ul>

<ul>
<li class="fragment">for 4 years <span class="db8orange">without updating</span></li>
</ul>

----

### Better: <span class="db8orange">Composer</span>

<ul>
  <li><span class="db8orange">Dependency manager</span> for PHP projects</li>
  <li class="fragment">Handles downloading, installing, and <span class="db8orange">updating</span></li>
  <li class="fragment">Uses <span class="db8orange">composer.json</span> to define project requirements</li>
  <li class="fragment">Stores packages in folder: <span class="db8orange">/vendor/</span></li>
  <li class="fragment">Automates library installation & <span class="db8orange">autoloading</span></li>
  <li class="fragment">Keeps versions in sync with <span class="db8orange">composer.lock</span></li>
  <li class="fragment"><span class="db8orange">Huge ecosystem</span> via Packagist.org</li>
</ul>

----

### <span class="db8orange">Packagist</span>

Search <a href="https://packagist.org/?query=joomla" target="_blank">Joomla packages</a>:
```bash
open https://packagist.org/?query=joomla
```

Install a package:
```bash
composer require joomla/http
```

Autoloading:
```php
<?php
require __DIR__ . '/vendor/autoload.php';
```

---

<div class="title">Using <span class="db8orange">libraries <strong>inside</strong> Joomla</span><br></div>

----

### Using libraries <span class="db8orange">inside</span> Joomla

Joomla from <a href="https://github.com/joomla/joomla-cms" target="_blank">joomla-cms github repo</a>?</br>

Need to do <a href="https://docs.joomla.org/J4.x:Setting_Up_Your_Local_Environment#Steps_to_Set_up_the_Local_Environment" target="_blank">
Steps to Set up the Local Environment</a>

----

### Using libraries <span class="db8orange">inside</span> Joomla

Joomla from <a href="https://downloads.joomla.org/" target="_blank">downloads.joomla.org</a>?</br>

<div style="display:flex; align-items:flex-start; justify-content:space-between;">
    <div class="fragment" style="flex:1; margin-right:20px; font-size:26px; line-height:1.5;">
        All libraries have been added<br><br>
        Joomla ships libraries under <span class="db8orange">/libraries/vendor/</span><br><br>
        <span class="db8orange">Do NOT update</span> those yourself!
    </div>
    <img class="fragment" 
         src="images/25-joomla-framework/libraries-vendor.png" 
         alt="Joomla"
         style="border:0; background:transparent; margin:0 20px; box-shadow:0 0 0 rgba(0,0,0,0.15); max-width:30%; height:auto;">
    <img class="fragment" 
         src="images/25-joomla-framework/libraries-vendor-joomla.png" 
         alt="Joomla's libraries"
         style="border:0; background:transparent; margin:0 20px; box-shadow:0 0 0 rgba(0,0,0,0.15); max-width:30%; height:auto;">
</div>

----

### Using <span class="db8orange">composer</span> libraries<br><span class="db8orange">inside</span> your extension

<div style="display:flex; align-items:flex-start; justify-content:space-between;">
    <div class="fragment" style="flex:1; margin-right:20px; font-size:26px; line-height:1.5;">
    <span class="db8orange">Avoid conflicts</span> of own extension with core and other extensions!<br><br>
    Put vendor <span class="db8orange">inside your extension</span>
    <br><br>/components/com_mycomponent/vendor/
    </div>
    <img class="fragment" 
         src="images/25-joomla-framework/own-component-vendor.png" 
         alt="Joomla"
         style="border:0; background:transparent; margin:0 20px; box-shadow:0 0 0 rgba(0,0,0,0.15); max-width:30%; height:auto;">
</div>

---

<div class="title">Using <span class="db8orange">libraries <strong>outside</strong> Joomla</span><br></div>

----

### Example 1: <span class="db8orange">Hello Joomla world</span>

Install a single package:
```bash
composer require joomla/registry
```

Use that package:

```php
<?php
require __DIR__ . '/vendor/autoload.php';

use Joomla\Registry\Registry;

$registry = new Registry;
$registry->set('welcome', 'Hello Joomla world!');
echo $registry->get('welcome'); // Hello Joomla world!
```

----

### Example 2: <span class="db8orange">List articles from DB</span>

<ul>
  <li><span class="db8orange">Standalone PHP</span> app (no CMS) to query <strong>#__content</strong>
    <ul>
      <li><span class="db8orange">Features</span>
        <ul>
          <li>Headless; no Joomla CMS runtime</li>
          <li>Uses Joomla Framework via Composer</li>
          <li>Responsive output with <strong>Bootstrap 5</strong></li>
        </ul>
      </li>
      <li class="fragment"><span class="db8orange">Requirements</span>
        <ul>
          <li>PHP 8.1+ and Composer</li>
          <li>Access to a Joomla 4.x/5.x database</li>
          <li>Web server or <strong>php -S</strong></li>
        </ul>
      </li>
    </ul>
  </li>
</ul>

----

### Example 2:  quick start
Clone & install:
```bash
git clone https://github.com/pe7er/db8-joomla-framework-example
cd db8-joomla-framework-example
composer install
cp .env.example .env    # add DB credentials
php -S localhost:8000
```

Visit:
```
http://localhost:8000
```

---

<div class="title">Demo:<br><span class="db8orange">Simple Framework Example</span><br></div>

----

#### Demo: simple framework example 1/4

1. get necessary libraries
```bash
composer require joomla/database
```

2. add autoload:
```php
require_once __DIR__ . '/vendor/autoload.php';
```
3. add namespace

```php
use Joomla\Database\DatabaseFactory;
```

----

#### Demo: simple framework example 2/4

4. add database credentials
```php
$config = [
    'driver' => 'mysqli',
    'host' => '10.10.10.10',
    'user' => 'dbuser',
    'password' => '123',
    'database' => 'dbname',
    'port' => '3306',
    'socket' => '',
    'prefix' => 'jd25_'
];
```

(actually, not recommended to add in code!)

----

#### Demo: simple framework example 3/4

5. Instantiate new DatabaseFactory object

```php
$db = (new DatabaseFactory())->getDriver(
    $config['driver'],
    $config
);
```

----

#### Demo: simple framework example 4/4

6. get and display data

```php
echo "<h1>Simple Framework Example</h1>";
$query = $db->getQuery(true)
    ->select('*')
    ->from($db->quoteName('#__content'));
$db->setQuery($query);
$rows = $db->loadObjectList();

print_r($rows);
```

----

## References
- **Framework portal**: https://framework.joomla.org/
- **GitHub org**: https://github.com/joomla-framework
- **Packagist (search)**: https://packagist.org/?query=joomla
- **Article (source)**: https://magazine.joomla.org/all-issues/april-2025/what-is-joomla-framework-and-how-can-you-use-it

----

## Contribute
- Help improve **docs**
- Maintain / enhance packages
- Share examples and tutorials

---

<div class="title"><span class="db8orange">Questions?</span></div>

----

## Photo Credits

<ul style="font-size:50%">
  <li><a href="https://unsplash.com/photos/a-group-of-men-standing-around-a-building-under-construction-YybYC5zC1Mk">Photo: men around building under construction</a></li>
  <li><a href="https://pixabay.com/photos/notebook-paper-pages-open-731212/">Photo: open notebook paper pages</a></li>
  <li><a href="https://unsplash.com/photos/boy-in-grey-crew-neck-t-shirt-plays-lego-bricks-with-white-manual-book-Z9AU36chmQI">Photo: boy playing with lego + manual book</a></li>
  <li><a href="https://unsplash.com/photos/photo-of-library-hall-dsvJgiBJTOs">Photo: library hall interior</a></li>
  <li><a href="https://unsplash.com/photos/icon-jHpWlTj8gVw">Photo: icon / logo (jHpWlTj8gVw)</a></li>
  <li>Queen Mary’s Gate, Kinross, Scotland — Peter Martin</li>
  <li><a href="https://unsplash.com/photos/a-group-of-white-and-orange-objects-IVGZ6NsmyBI">Photo: white & orange objects</a></li>
</ul>

</section>