NipTrait

validateNip($nip)   - Sprawdza poprawność     - Invoice::validateNip('1234567890') → true 
normalizeNip($nip)  - Usuwa myślniki, spacje  - Invoice::normalizeNip('123-456-78-90') → '1234567890'
formatNip($nip)     - Formatuje XXX-XXX-XX-XX - Invoice::formatNip('1234567890') → '123-456-78-90'
generateRandomNip() - Generuje losowy - NIP   - Invoice::generateRandomNip() → '857-234-19-23'
getTestNip()        - Stały NIP testowy       - Invoice::getTestNip() → '123-456-78-16'
isForeignNip($nip)  - Czy NIP zagraniczny     - Invoice::isForeignNip('9912345678') → true 
getNipInfo($nip)    - Debug info Zwraca tablicę z detailami 

seller_nip_formatted - Virtual field - $invoice->seller_nip_formatted → '123-456-78-90' 
buyer_nip_formatted  - Virtual field - $invoice->buyer_nip_formatted → '123-456-78-90'

Czytaj dalej NipTrait

Nowy user

# adduser nowy_user

// User nowy_user dodany do grupy sudo - uprawnienia roota
# usermod -aG sudo nowy_user

KSEF

https://web2tr-ksef.mf.gov.pl/web/  – strona logowania

– uwierzytelnienie za pomocą podpisu zaufanego, podpisanie dokumentu

// ============================================
// KROK 2: IMPLEMENTACJA KSEFCLIENT I AUTORYZACJA 
// ============================================
//
// W KSeF API 2.0 proces uwierzytelniania składa się z 3 kroków:
// 1. Pobranie challenge (POST /auth/challenge)
// 2. Przygotowanie żądania autoryzacyjnego z tokenem i challenge
// 3. Uzyskanie JWT accessToken

// ============================================
// Plik: src/KSeF/KSeFClient.php
// ============================================
# composer require guzzlehttp/guzzle: ^7.10
# composer require phpseclib/phpseclib:~3.0
Upewnij się że PHP ma włączone rozszerzenie OpenSSL:
# php -m | grep openssl
(powinno pokazać "openssl")

odsumowanie Kroku 2:

Co zbudowaliśmy:

  • ✅ KSeFClient.php – pełna implementacja uwierzytelnienia
  • ✅ Szyfrowanie RSA-OAEP SHA-256 (phpseclib + OpenSSL fallback)
  • ✅ Proces 3-krokowy KSeF 2.0:
    1. POST /auth/challenge
    2. POST /auth/ksef-token
    3. GET /auth/{referenceNumber} (polling)
    4. POST /auth/token/redeem
  • ✅ Zarządzanie JWT tokenami
  • ✅ Kontroler testowy do łatwego testowania: src/Controller/KsefTestController.php

Kluczowe nauki:

  • KSeF 2.0 wymaga RSA-OAEP z SHA-256 (nie SHA-1!)
  • Format szyfrowania: token|timestampMs (bez challenge)
  • Struktura JSON: płaska (bez credentials)
  • Proces jest asynchroniczny – wymaga pollingu

CO DALEJ? – KROK 3

Teraz mamy accessToken i możemy przejść do wysyłania faktur!

Krok 3 będzie obejmował:

  1. Budowanie faktury w formacie FA(3) XML
  2. Szyfrowanie faktury (AES-256-CBC)
  3. Otwarcie sesji online
  4. Wysłanie faktury do KSeF
  5. Pobranie UPO (Urzędowego Poświadczenia Odbioru)
  6. Pobieranie faktur z KSeF

Moduł wysyłania faktur!

To będzie obejmowało:

  • Klasę FakturaBuilder do tworzenia XML FA(3)
  • Szyfrowanie AES-256-CBC
  • Sesje online
  • Wysyłkę faktur

Dostęp do innej tabeli z Modelu

W modelu Table nie można użyć metody $this->fetchTable(„Projects”)  – ta metoda dostępna jest tylko dla Controllers.

src/Model/Table/InvoicesTable.php

use Cake\ORM\TableRegistry;

class InvoicesTable extends Table
{

  public function getProjects() { 
    
    $projects = TableRegistry::getTableLocator()->get('Projects')
                  ->find()
                  ->where(['is_active' => 1])
                  ->all();
    ....
  } // getProjects()
...

} // class

Rsync

Wszystkie pliki i podkatalogi /home/john/my_app/ zostaną wgrane do  roboczego katalogu .

# rsync -av johnny@194.127.230.100:/home/johnny/my_app/ .

Backup zostanie wgrany ze zdalnego systemu do katalogu roboczego

# rsync -av johnny@194.137.231.100:/home/johnny/backup/myapp-20251120.sql .

CakePHP 5 – Formularz – Powiązania modeli

$this->Form->create($article);

// Article controls.
echo $this->Form->control('title');

// Author controls (belongsTo)
echo $this->Form->control('author.id');
echo $this->Form->control('author.first_name');
echo $this->Form->control('author.last_name');

// Author profile (belongsTo + hasOne)
echo $this->Form->control('author.profile.id');
echo $this->Form->control('author.profile.username');

// Tags controls (belongsToMany)
// as separate inputs
echo $this->Form->control('tags.0.id');
echo $this->Form->control('tags.0.name');
echo $this->Form->control('tags.1.id');
echo $this->Form->control('tags.1.name');

// Inputs for the joint table (articles_tags)
echo $this->Form->control('tags.0._joinData.starred');
echo $this->Form->control('tags.1._joinData.starred');

// Comments controls (hasMany)
echo $this->Form->control('comments.0.id');
echo $this->Form->control('comments.0.comment');
echo $this->Form->control('comments.1.id');
echo $this->Form->control('comments.1.comment');

$this->Form->end();

Czytaj dalej CakePHP 5 – Formularz – Powiązania modeli