JBoss+CGI/FastCGI环境下PHP无法加载PATH环境变量求助

Let's break down the solution to get your PATH and other critical environment variables showing up in phpinfo() (and working with oci_connect()) under JBoss's CGI/FastCGI setup:

• Configure JBoss FastCGI Handler to Pass Environment Variables
  Locate your JBoss configuration file (either standalone.xml for standalone mode or domain.xml for domain mode) and find the FastCGI handler definition. Add explicit environment variable mappings here to ensure PATH and Oracle-related variables are passed to the PHP FastCGI process:

  <handler name="php-fcgi" class="org.jboss.as.web.cgi.CGIAccessHandler">
      <environment-variables>
          <!-- Include your full PATH, adding the Oracle Instant Client bin directory -->
          <variable name="PATH" value="C:\Program Files (x86)\Common Files\Oracle\Java\javapath;C:\Program Files (x86)\RSA SecurID Token Common;C:\path\to\your\oracle\instantclient\bin;%PATH%" />
          <!-- Add Oracle-specific variables if needed -->
          <variable name="ORACLE_HOME" value="C:\path\to\your\oracle\home" />
      </environment-variables>
  </handler>
  

  The %PATH% placeholder preserves your system's existing PATH, so you don't lose access to other required binaries.

• Set Environment Variables in JBoss's Startup Script
  If you launch JBoss via a batch script (like standalone.bat), add the environment variable definitions at the top of the script before JBoss starts. This ensures the entire JBoss process (and its FastCGI child processes) inherits these variables:

  :: Add these lines at the start of standalone.bat
  set PATH=C:\Program Files (x86)\Common Files\Oracle\Java\javapath;C:\Program Files (x86)\RSA SecurID Token Common;C:\path\to\your\oracle\instantclient\bin;%PATH%
  set ORACLE_HOME=C:\path\to\your\oracle\home
  

• Adjust Windows Service Environment (If JBoss Runs as a Service)
  If JBoss is installed as a Windows service, you can't rely on the startup script. Instead:

  1. Open the Windows Services Manager (services.msc)
  2. Find your JBoss service, right-click it, and select Properties
  3. Go to the Environment tab
  4. Add PATH and ORACLE_HOME variables with the correct values
  5. Click OK and restart the JBoss service

• Verify FastCGI Isn't Blocking Environment Variables
  Double-check your PHP FastCGI configuration files (like php-fcgi.conf or any custom configs) to ensure there's no setting that restricts the environment variables passed to PHP. Some FastCGI setups have a whitelist of allowed variables—make sure PATH, ORACLE_HOME, and others are included.

• Restart and Validate

  1. Fully stop JBoss (don't just reload configs—this avoids caching issues)
  2. Start JBoss back up
  3. Load your phpinfo() page and check the Environment section—you should now see PATH and other configured variables
  4. Test your oci_connect() call to confirm it can now connect to the Oracle database

Quick Note: Make sure your Oracle Client version (32-bit vs 64-bit) matches your PHP and JBoss architectures. Mismatched bitness will cause the OCI library to fail loading even if PATH is correct.

内容的提问来源于stack exchange，提问作者Mohammad Tanzeel