claudetools/docs/forum-posts/freepbx17-pjsip-trunk-name-reload-fix.md

Fix: FreePBX 17 "Undefined array key trunk_name" on fwconsole reload

Environment

• FreePBX 17 (Sangoma FreePBX Distro)
• OS: Debian 12 (bookworm)
• Asterisk: PJSIP driver
• Trunk: Single PJSIP trunk (FirstDigital)

Problem

fwconsole reload fails with:

In PJSip.class.php line 504:
  Undefined array key "trunk_name"

This prevents any configuration changes made in the FreePBX GUI from being applied to Asterisk. DIDs, transfers, and other call routing changes silently fail to take effect.

Diagnosis

The Bug

The getAllTrunks() method in PJSip.class.php (line ~1606) uses this SQL query:

SELECT id, keyword, data FROM pjsip as tech
LEFT OUTER JOIN trunks ON (tech.id = trunks.trunkid) OR (tech.id = trunks.trunkid)
WHERE trunks.disabled = 'off' OR trunks.disabled IS NULL

The trunks.disabled IS NULL condition catches rows from the pjsip table that have no matching entry in the trunks table — which includes all extension data (extensions 201, 202, 235, etc. are stored in the same pjsip table). Extensions don't have a trunk_name field, so line 504 crashes:

$tn = $trunk['trunk_name'];  // line 504 - crashes for extensions

Additional Issue: Orphaned Trunk Data

We also found an orphaned trunk in the pjsip table:

SELECT id, keyword, data FROM pjsip WHERE keyword='trunk_name';
-- Returns:
-- id=1, trunk_name=FirstDigital      (valid - exists in trunks table)
-- id=2, trunk_name=FirstDigital_SIP  (orphan - NO matching entry in trunks table)

This orphan was likely created by a partially-deleted trunk configuration.

Side Effect: Broken Logging

We also discovered that /var/log/asterisk/full was empty — the logger had no file output configured. This masked the problem since no call errors were being recorded.

Fix

Step 1: Patch PJSip.class.php

File location:

/var/www/html/admin/modules/core/functions.inc/drivers/PJSip.class.php

Backup first:

cp /var/www/html/admin/modules/core/functions.inc/drivers/PJSip.class.php \
   /var/www/html/admin/modules/core/functions.inc/drivers/PJSip.class.php.bak

Replace line 504:

// BEFORE (line 504):
$tn = $trunk['trunk_name'];

// AFTER:
$tn = $trunk['trunk_name'] ?? null; if ($tn === null) { continue; }

Using sed:

sed -i "504s/.*/\t\t\t\$tn = \$trunk['trunk_name'] ?? null; if (\$tn === null) { continue; }/" \
  /var/www/html/admin/modules/core/functions.inc/drivers/PJSip.class.php

Step 2: Clean Up Orphaned Trunk Data (if present)

Check for orphans:

-- Run in mysql:
SELECT p.id, p.data FROM pjsip p
WHERE p.keyword='trunk_name'
AND p.id NOT IN (SELECT trunkid FROM trunks);

Remove any orphans found:

-- Replace '2' with the orphaned ID from the query above
DELETE FROM pjsip WHERE id='2';

Step 3: Restore Asterisk Logging

If /var/log/asterisk/full is empty and logger show channels shows no file output:

echo 'full => notice,warning,error,verbose,dtmf,fax' > /etc/asterisk/logger_logfiles_custom.conf

Step 4: Reload

fwconsole reload
# Should output: Reload Complete (no errors)

Verify logging:

asterisk -rx "logger show channels"
# Should show: /var/log/asterisk/full  File  default  Enabled

Verification

# Reload should succeed cleanly
fwconsole reload
# Output: Reload Started / Reload Complete

# Asterisk should be logging
wc -l /var/log/asterisk/full
# Should be non-zero and growing

# Trunk should be connected
asterisk -rx "pjsip show endpoint <trunk_name>"
# Contact status should show "Avail"

Important Notes

• This patch will be overwritten on FreePBX module updates. After running fwconsole ma updateall or updating the Core module, check if the fix is still in place.
• The root cause is a bug in FreePBX's getAllTrunks() SQL query that doesn't properly filter extensions from trunk data. An upstream fix would modify the query to use INNER JOIN or add a WHERE clause filtering on pjsip.keyword = 'trunk_name'.
• The orphaned trunk data suggests a trunk was deleted through the GUI but the pjsip table wasn't fully cleaned up — a separate FreePBX bug.